roadmap.sh 是地图,不是课程

nilbuild/developer-roadmap 是 roadmap.sh 背后的仓库。它收集了面向开发者角色、技术栈和职业路径的互动学习路线图:frontend、backend、DevOps、full stack、computer science、AI engineer、data engineer、machine learning、system design、Kubernetes、Rust、Go、React、Node.js、product management、engineering management 等。

最合适的读法是把它当地图。它不是 freeCodeCamp 那样的完整课程平台,也不是 OSSU 那种大学式课程路径,更不是一本面试书。roadmap.sh 回答的是另一个问题:我下一步该学什么,这些主题之间是什么关系。

截至 2026-06,这个仓库有 356,750 star、44,191 fork 和 13 个开放 issue。它是 TypeScript 项目,官网是 https://roadmap.sh,最近一次 push 是 2026-06-10。当前 GitHub slug 是 nilbuild/developer-roadmap;旧的 kamranahmedse/developer-roadmap 路径会解析到同一个仓库。这个细节很重要,因为很多旧文章和收藏链接仍在用旧 owner。

仓库里有什么

README 列出了大量路线图。核心职业路径包括 Frontend、Backend、DevOps、DevSecOps、Full Stack、QA、Product Manager、Engineering Manager、Software Architect、Data Analyst、Data Engineer、AI Data Scientist、AI Engineer、MLOps、Network Engineer、Cyber Security、Technical Writer、DevRel、Forward Deployed Engineer 和 Game Developer。

技术路径覆盖常见开发栈:HTML、CSS、JavaScript、TypeScript、Python、Django、Go、Rust、Java、Kotlin、Spring Boot、C++、PHP、Laravel、Ruby、Rails、Android、iOS、Flutter、React、Next.js、React Native、Vue、Angular、Node.js、GraphQL、SQL、PostgreSQL、Redis、MongoDB、Elasticsearch、Docker、Kubernetes、Terraform、AWS、Cloudflare、Linux、Bash 等。

仓库还有 best-practice 和 question 内容。README 链到了 backend performance、frontend performance、code review、API security、AWS best practices,也有 JavaScript、Node.js、React、backend、frontend 的 questions。近期 roadmap 目录还包括 ai-agents、ai-engineer、ai-red-teaming、claude-code、openclaw 和 vibe-coding 这类 AI 相关路径。

广度就是它的价值。学习者可以先比较路线,再决定要把几个月投入到哪条路径里。

本地开发

README 给了真实本地 setup。它不是库的安装命令,而是本地运行 roadmap.sh app 的方式。README 使用浅克隆,这里写成普通 clone,方便正文保持可复制:

git clone [email protected]:nilbuild/developer-roadmap.git
cd developer-roadmap
pnpm add @roadmapsh/editor@npm:@roadmapsh/dummy-editor -w
pnpm install

然后运行开发服务器:

pnpm dev

README 还提醒运行前把 .env.example 改名为 .env。这一步只复制命令时很容易漏。如果你只是使用路线图,不需要本地运行,直接用 roadmap.sh 即可。本地开发更适合贡献内容、改站点或测试路线图编辑。

贡献规则说明了产品品味

contributing guide 是理解 roadmap.sh 编辑模型的最好材料。新路线图可以用文本路线图开 issue,也可以用 roadmap editor 做好后提交链接。已有路线图里的 typo 可以直接改 markdown 文件,但增加或删除节点应该先开 issue。

最重要的规则是:项目并不追求收录所有东西。贡献指南说,目标是列出今天最有价值的技能。它要求贡献者不要添加自己没有评估过的内容,topic popup 要简洁,每个 topic 最多 8 个资源链接。它还拒绝 GeeksforGeeks 链接,并反对 self-promotion。

这套编辑立场解释了项目为什么还能读。路线图一旦收录所有工具,就会退化成目录。roadmap.sh 有用,是因为它试图按现实学习顺序和当前相关性排列主题。

许可边界

不要把这个仓库内容当成宽松许可的 open educational resource。GitHub 给出的 license 是 NOASSERTION,license 文件是自定义版权声明。它允许 personal use,允许分享仓库或 roadmap.sh 链接,但限制在未经许可时重新发布 repository 里的 images、project files 或 content。把路线图图片或内容放进 blog、newsletter、course 或 internal wiki 前,需要先读 license。

这个点对 roadmap.sh 比普通代码库更重要。真正有价值的资产不只是 app shell,而是被整理过的路线图内容。

近期 issue 显示它已经是应用

当前 issue tracker 看起来不像静态列表。近期 issue 包括 Network Engineer 和 LeetCode 的路线图反馈、question length 超过 500 characters 导致 quiz 无法作答、AI-related 404,以及 leaderboard 的 Active 列表显示用户数异常。近期 PR 包括 AI quiz verify 修复,以及给 product-manager 和 server-side-game-developer topic 增加资源链接。

这些 issue 说明 roadmap.sh 已经变成互动学习产品。Roadmaps、quizzes、questions、leaderboards、编辑器或生成内容都会带来产品 bug。这和 markdown-only awesome list 不同,后者主要问题通常只是链接过期。

对用户来说,这是好信号,也是提醒。站点提供的学习面比静态图更多,但新路径或 quiz 也可能有粗糙边缘。

和 freeCodeCamp、OSSU、CIU、system-design-primer 怎么比

freeCodeCamp/freeCodeCamp 是有 interactive lessons、projects、progress 和 certificates 的学习平台。想要引导式练习和结业凭证时选它。roadmap.sh 更适合在选课程或做项目之前,先判断下一步该学什么。

OSSU computer-science 是自学 CS 的课程地图。截至 2026-06,它有 204,803 star,主要把学习者引向外部课程。想按接近 CS degree 的路径走,选 OSSU。需要 backend、DevOps、AI engineer、Kubernetes 这类角色或技术路径时,roadmap.sh 更合适。

The Odin Project curriculum 是结构化 web development 路径。它比 roadmap.sh 窄,也更像课程。如果你已经确定要学 web development,它很值得看。roadmap.sh 更适合做决定前比较路径,或在想转到另一条技术线时使用。

jwasham/coding-interview-university 是面试导向学习计划,截至 2026-06 有 351,116 star。它更适合长周期 interview preparation。donnemartin/system-design-primer 截至 2026-06 有 352,595 star,更适合 system design interview。roadmap.sh 覆盖职业规划和很多技术路径,但不能替代专门的面试准备。

什么时候适合用 roadmap.sh

当你开始一轮学习、需要选择路径、盘点知识缺口,或给别人解释职业路线时,roadmap.sh 很适合。它尤其适合被大量主题淹没的学习者,因为可视化顺序能减少迷路感。团队做 onboarding 也可以用它定义 frontend basics、backend basics、DevOps basics 或具体语言路径。

不要把它当唯一学习材料。路线图告诉你学什么,真正掌握还要靠项目、官方文档、真实 bug 和反馈。实践材料可以搭配 codecrafters-io/build-your-own-x、freeCodeCamp、The Odin Project、官方 docs 或自己的项目。

这个仓库的强项是定位方向。风险是 checklist learning:只标记节点,但没有真正做题、写代码或交付项目。把每个节点当成决策点,不要当奖章。

Star 曲线怎么看

采样 star history 显示,developer-roadmap 从 2017 年的学习地图成长为 GitHub 上最大的教育类仓库之一。由于仓库体量很大,曲线是抽样结果,不要过度解读单个点位间距。真正耐久的信号是:按角色组织学习路径这件事,穿过了 frontend 变化、cloud 普及、面试准备和最近的 AI 工具周期,仍然有需求。

最新 README 也说明项目还在增加新路径,而不只是维护传统 frontend 和 backend 图。这就是它仍然值得写的原因。

相关阅读

如果你需要有练习和证书的平台,读 freeCodeCamp/freeCodeCamp。选完路径后想找项目练习,看 codecrafters-io/build-your-own-x。更广的开发者资源列表可以看 sindresorhus/awesome。更大的发现入口是 GitHub trending repositories。

FAQ

nilbuild/developer-roadmap 是什么? 它是 roadmap.sh 背后的 GitHub 仓库,包含互动开发者路线图、guides、best practices 和 questions。

roadmap.sh 等同于课程吗? 不等同。它主要是学习地图,告诉你学什么和大致顺序。你仍然需要课程、文档、项目和练习。

为什么有些链接写 kamranahmedse/developer-roadmap? 旧的 GitHub 路径现在会解析到 nilbuild/developer-roadmap。截至 2026-06,当前 slug 是 nilbuild/developer-roadmap。

我可以把 roadmap.sh 内容放进自己的文章或课程吗? 先读 license。这个仓库使用自定义版权声明,不是标准宽松内容许可证,未经同意重新发布内容有限制。

如何本地运行 roadmap.sh? 克隆仓库,运行 pnpm add @roadmapsh/editor@npm:@roadmapsh/dummy-editor -w,再运行 pnpm install,把 .env.example 改名为 .env,最后运行 pnpm dev。