Skip to content
返回博客Back to blog

写作Writing

为技术作品集网站设计真正有说服力的案例研究Designing Case Studies for Technical Portfolio Sites

怎样组织案例研究,才能证明判断力,而不只是展示结果。How to structure a case study so it proves judgment, not just output.

产品构建Product Building
2026年5月5日May 5, 20266 分钟阅读6 min readLinfeng Chen更新于 2026年5月7日Updated May 7, 2026
portfolio
case-study
writing
nextjs

一个好的案例研究,不是项目复盘,也不是宣传册。它更像是一份证据,说明这项工作是被有意识地塑形过的。

我常用的结构

我会把结构收得很简单:

SectionJob
Context说明工作从什么状态开始
Problem说清真正的摩擦点
Constraints说明哪些东西不能动
Process交代判断是怎么做出来的
Solution说明到底做了什么
Result说明什么发生了变化

中段最重要

页面中段是判断真正发生的地方。我希望在那里看到:

  • 取舍
  • 被放弃的路径
  • 为什么这条路比另一条更合适
  • 哪些步骤是有意保持人工处理的

一个案例研究最有价值的时候,是它让下一个项目更容易被信任。

不要这么写

  • 不要把每一段都写成营销文案。
  • 不要隐藏约束。
  • 不要绕开真正的决策过程。
  • 不要用一个项目假装自己同时解决了五种不同的问题。

一个简单测试

如果读完整页之后,别人仍然看不出“你本人具体做了什么”,那这页就太虚了。
如果别人只能看出你做了哪些功能,却看不出为什么这些决定重要,那这页又太浅了。

这个中间地带,恰恰就是案例研究的工作。

A good case study is not a project recap. It is proof that the work was shaped on purpose.

The shape I use

I keep the structure simple:

SectionJob
ContextExplain where the work started
ProblemName the real friction
ConstraintsShow what could not change
ProcessShow how decisions were made
SolutionShow what was built
ResultShow what changed

What belongs in the middle

The middle of the page is where judgment lives. This is where I want to see:

  • Tradeoffs
  • Rejected paths
  • Why one route was better than another
  • What stayed manual on purpose

A case study should make the next project easier to trust.

What not to do

  • Do not turn every section into marketing copy.
  • Do not hide constraints.
  • Do not write around the decision-making.
  • Do not use one project to pretend you solved five different problems.

A useful test

If someone reads the page and cannot tell what you personally did, the page is too vague. If they can tell exactly what you built but not why it mattered, the page is too shallow.

That middle ground is the whole job.

相关工作Related work

和这篇笔记关联的项目与案例研究。Projects and case studies connected to this note.

项目Projects

技术品牌系统Technical Brand System

一个面向案例、服务、写作与项目证明的可维护内容与作品集系统。A maintainable content and portfolio system for case studies, services, writing, and project proof.

产品product
建筑事务所网站Architecture Studio Website

一个兼顾图片叙事与可维护结构的作品集系统。A refined portfolio system that balances image-led presentation with maintainable structure.

客户项目client-work

案例研究Case studies

为建筑事务所打造更精致的作品集系统Building a Refined Portfolio System for Architecture Studios

一个以图片叙事为主、同时保持易维护的平静型作品集结构。A calm, image-led portfolio structure that still stays easy to maintain.

建筑事务所Architecture studio
把静态索引改造成可维护的 AI 辅助发布工作流Turning a Static Index into a Maintainable AI-Assisted Publishing Workflow

一个无需先上 CMS、却能让笔记、来源与草稿输出保持对齐的发布系统。A publishing system that keeps notes, sources, and draft output aligned without forcing a CMS.

独立产品项目Independent product build

相关文章Related posts

和这个主题相邻的更多笔记。More notes close to this topic.

把 KizunaIndex 做成公共索引之后,我学到的几件事Lessons from Building KizunaIndex as a Public Index

精选Featured
产品构建Product Building
2026年5月1日May 1, 20267 分钟阅读7 min read更新于 2026年5月3日Updated May 3, 2026

公共索引真正有用,往往不是因为页面多复杂,而是因为内容模型足够小、足够清楚、足够容易改。A public index gets more useful when the content model is small, explicit, and easy to revise.

nextjs
data-modeling
public-index
阅读全文Read article

用本地工具和云模型搭建个人 AI 工作台Building a Personal AI Workbench with Local Tools and Cloud Models

精选Featured
AI 工程AI Engineering
2026年5月8日May 8, 20268 分钟阅读8 min read更新于 2026年5月10日Updated May 10, 2026

一个实用的 AI 工作环境:能起草、测试和发布,又不会把流程缠在一起。A practical setup for drafting, testing, and shipping AI work without letting the workflow get tangled.

ai-agent
automation
codex
阅读全文Read article

用 Next.js、Vercel 和 Supabase 发布小型 Web 产品Shipping Small Web Products with Next.js, Vercel, and Supabase

部署Deployment
2026年4月18日April 18, 20265 分钟阅读5 min read更新于 2026年4月22日Updated April 22, 2026

当部署、数据和界面都足够好理解时,这套小产品栈才真正好用。A small product stack works best when deployment, data, and UI stay easy to reason about.

nextjs
vercel
supabase
阅读全文Read article