GitHub 主页搭建指南

它解决什么问题

GitHub 主页本质上是开发者的默认简历——别人点进你的 profile，通常只停留几秒。但大多数主页的问题不是内容太少，而是层级混乱：顶部写着“你好我是 XXX”，下面排满技能标签和统计卡片，访客读完依然不知道你是谁、能做什么、做过什么。

这个技能要解决的是“十秒讲清自己”：不是往页面里堆更多卡片，而是把信息按访客的阅读顺序重新排列。

它是怎么工作的

技能以“技术形象设计师”的角色运行，把社区里的优秀案例沉淀成一套可复用的搭建框架，使用时按五个步骤推进：

• 开同名仓库：新建一个与用户名完全相同的仓库，GitHub 会把它渲染成 profile 页。
• 写一句定位：顶部放一句“你是谁、在做什么”，而不是寒暄式自我介绍。
• 接动态卡片：通过 Readme Stats、贡献蛇等第三方服务生成活跃度证明，注意用户名参数要填对。
• 置顶代表作：精选 3–5 个项目，写清楚每个项目解决了什么问题。
• 加联系入口：底部放邮箱或社交链接，让访客有处可去。

信息顺序是固定的：一句话定位、技术栈标签、动态统计、精选项目、社交链接。每一步都配有检查项，例如动态卡片能否正常加载、首屏是否因堆砌而变慢。

适用边界与注意点

这套框架最适合从零搭建或整体重做主页的场景。仓库多、经历长的人尤其要克制：标签和卡片堆得再多，也不会让主页更有说服力。

实际落地有两类坑：一是第三方依赖，动态统计依赖 Readme Stats 等服务，服务失效或无人维护后页面会裂图；二是隐私，部分统计服务会展示不应公开的个人数据，接入前先确认其隐私政策。