想学点技术的上班族,十有八九卡在同一个地方:教程一搜一大把,第一步照着敲完了,可第二步学什么、跟第一步怎么接上,没人告诉你。收藏夹存了几十篇,越存越乱,最后一篇没看完。真被问一句「那我第二步学啥」,大多数人只能支支吾吾。

今天说的这个项目,叫 developer-roadmap。据榜单抓取数据(2026 年 10 月 22 日上午),它在 GitHub 全站总星数榜上排第 8 名,370,073 颗星,fork(别人把仓库复制一份自己改着用的次数)45,130 次。这个仓库 2017 年 3 月 15 日建仓,到现在九年半了还在更新,据 GitHub 仓库页面显示,最近一次推送是 10 月 20 日,就两天前。它背后是一个叫 roadmap.sh 的网站——路线图(roadmap),说白了就是一张画好的学习地图:先学什么、后学什么、每块知识跟哪些知识搭着,一条线给你连起来。

先说它是个啥。按项目 GitHub 页介绍,它不是代码库,也不是教程合集,是 roadmap.sh 这个网站背后的内容仓。你在网站上看到的每一张路线图,图上每个可以点击的圆点,对应的说明文字都存在这个仓库里,一个主题一个文件。地图在网站上画着,资料在仓库里存着,两边是通的。

里面都有什么,我按官方 README 的条目过一遍。核心是 88 条路线图条目,铺得很开:想做网页的,有前端(你在屏幕上看见的界面)、后端(藏在服务器里处理数据和请求的那半边)、全栈(前后端都干)路线图,还细分到 HTML、CSS、JavaScript、React、Vue 这些单项目的;管服务器的,有 DevOps(开发加运维,管程序怎么又快又稳地跑在生产机器上)、Linux、Docker、Kubernetes(一套管着成百上千台机器跑程序的调度系统)路线图;AI 方向的更多,AI 工程师、AI 智能体(能自己拆任务、调工具干活的 AI 程序)、机器学习、提示词工程(琢磨怎么给 AI 下指令让活干得更好)、AI 红队(专门给 AI 找漏洞做安全测试)都单独立了图;还有按职位来的,数据分析师、产品经理、游戏开发者,甚至刚冒头的新条目,Claude Code、Vibe Coding(用嘴描述需求让 AI 写代码的干法),2017 年画到现在,新东西一出就往上补。

除了路线图,还有两块。一是 5 条官方整理的实践清单(英文叫 Best Practices):后端性能、前端性能、代码评审、API 安全、AWS,也是图的形式,把某一件事里公认该做对的要点串起来。二是 5 套自测题:JavaScript、Node.js、React、前端、后端各一套,学完自己点一点,看是真会了还是以为自己会了。另外不少主路线图还配了入门版,同一个主题分两张图,一张给零基础的,一张给有点底子的,不用一上来就被劝退。

它解决的麻烦,说白了就是两个。一个是「散」:知识到处都是,顺序没人给,一张图把先后和关联画出来,你照着节点走就知道自己在哪一步。另一个是「贵」:市面上把「学习路径」当商品卖的不少,几千块的转行课,卖的其实就是一张计划表。这个项目把路径免费摊开,官网直接看,一分钱不收。星数为什么涨到 37 万,我猜跟这个有关系——大家都被「该学什么」这件事卡过。

用之前有两件事得知道。第一,它的许可证不是常规开源许可,按仓库里 license 文件写的,内容只允许个人使用,不能把图和文字搬出去再发布。所以这篇文章里我不放它的路线图截图,你想看图,去官网点开就是,这也正是它免费给大家的用法。第二,图给的是顺序,不给学时、不给考核,有的节点下是一篇正经文章,有的只有几行字加几个外链,按官方仓库的说明,节点内容的厚度取决于有没有人贡献。它告诉你路怎么走,学没学会得靠你自己验。

那 AI 在这里头能干什么用?我拆成装和用两层说。先说「装」:它其实谈不上安装,打开 roadmap.sh 网站就能用,这是官方设计的用法。如果你想连内容一起存到本地,把它的 README 丢给 AI 助手(豆包、元宝这类能传文件的都行),让它一步步带你敲命令;用 Claude Code、Cursor 这类能直接操作电脑的编程 AI 更省事,一句话让它代劳。这里有个官方 README 特意交代的坑:仓库体积有 355 MB,下载命令要加一个 –depth 1 参数(只拉当前版本、不拉九年历史记录),不加的话磁盘和时间都翻好几倍,AI 带装的时候记得让它照官方给的命令来。

再说「用」。网站上的图是能点的,可下载下来的文件是纯文本,点不动——这个缺口正好让 AI 补上。比如让 AI 从仓库里挑出你要的那条路线,把节点文件一个个翻成中文讲给你听;再比如你跟 AI 说「我每天只有晚上一小时,照前端入门这张图帮我排三个月的计划」,它能把图上的节点拆成你自己的周计划表。官方文档没提 MCP 接口或者自动化玩法,README 里提到的 scripts 目录是给维护者同步网站用的,不是给普通用户的,这块别想多了。

上个月我写过一份系统设计的免费教材,跟这个项目算半个亲戚:那份是死磕一个专题的深度教材,这个是把整个技术世界的路都画出来的地图集,两个搭着用正好。

项目地址:github.com/nilbuild/developer-roadmap,官网直接看图:roadmap.sh。

地图别人九年前就开始画了,还一直在更新。我先看明白了,你跟上。