学生如何用 GitHub 做作品集
· 荣十一 ·
很多学生的 GitHub 账号只有两种状态：空白，或者一堆看不懂的课程仓库。
其实 GitHub 很适合做作品集。它能展示你写过什么代码、怎么组织项目、有没有持续维护、是否会写说明文档。对技术方向学生来说，一个整理好的 GitHub，比简历里一句“熟悉 React / Python / Java”更有说服力。
先清理仓库
不要把所有练习代码都公开放在首页。
你可以保留练习仓库，但最好把真正想展示的项目整理出来。比如：
- 一个完整前端项目
- 一个后端 API 项目
- 一个数据分析 notebook
- 一个课程大作业
- 一个个人工具
- 一个博客或作品集网站
展示项目不一定要多，3 到 6 个高质量项目比 30 个空仓库更好。
README 要写给人看
一个好的 README 至少回答这些问题：
- 这个项目解决什么问题
- 用了什么技术栈
- 如何本地运行
- 有哪些主要功能
- 你负责了什么
- 有无线上预览地址
- 项目截图或演示图
不要只写：
npm install
npm run dev这只能说明项目能跑，不能说明项目为什么值得看。
给项目加部署链接
如果是前端或全栈项目，尽量部署一个在线版本。
可以用 Vercel、Cloudflare Pages、GitHub Pages 等平台。线上预览能降低别人查看项目的成本，也能证明你不只是本地跑通。
如果项目涉及后端、数据库或隐私数据，可以放截图和说明，不一定非要公开完整服务。
提交记录也会说话
很多人忽略 commit history。乱七八糟的提交虽然不致命，但会影响观感。
建议使用清楚的提交信息，比如：
feat: add search page
fix: handle empty upload queue
docs: update setup guide不用追求特别标准，但至少让人看得懂你每次改了什么。
Profile README 可以简单一点
GitHub 允许你创建一个和用户名同名的仓库，用来展示个人主页。
不要把 Profile README 做成贴纸墙。简单写清楚：
- 你是谁
- 关注什么方向
- 最近在做什么项目
- 代表项目链接
- 个人网站或联系方式
真实、清楚，比花哨更重要。
我的建议
把 GitHub 当成公开工作台，而不是代码垃圾桶。
每完成一个课程项目，都花半小时整理 README、截图和运行方式。四个学期下来，你会自然拥有一个可展示的作品集。到那时，简历不再只是写技能清单，而是能直接指向你做过的东西。