内容摘要：打开浏览器输入 runoob.com，页面加载出来的速度比想象中快。没有花哨的动效，没有弹窗广告，左侧一列导航栏干干净净地排着 HTML、CSS、JavaScript、Python 这些词条。这就是很

打开浏览器输入 runoob.com，菜鸟页面加载出来的教程速度比想象中快。没有花哨的官网动效，没有弹窗广告，菜鸟左侧一列导航栏干干净净地排着 HTML、教程CSS、官网JavaScript、菜鸟Python 这些词条。教程这就是官网很多人编程入门的第一个网站——菜鸟教程。

我第一次用它大概是菜鸟七八年前，那会儿想学 JavaScript，教程搜“js 教程”翻了好几页，官网要么是菜鸟培训机构挂出来的招生页，要么是教程博客园里某位前辈写了一半就断更的系列文章。菜鸟教程排在搜索结果靠前的官网位置，点进去，发现每一节都短得离谱——一个知识点配一段代码，代码下面直接标出运行结果。当时觉得这也太简陋了吧？后来才意识到，正是这种“简陋”救了我。

它把“够用”这件事做到了极致

市面上讲 JavaScript 的书动辄四五百页，光闭包能写一个章节。菜鸟教程的 JS 部分呢？从变量声明到 DOM 操作，每个页面控制在两三屏以内。比如讲 Array.prototype.map()，它不会花大篇幅跟你聊函数式编程的哲学背景，直接给一个数组，演示怎么用 map 把每个元素乘二，然后告诉你返回值是新数组、原数组不变。看完就能上手用。

这种风格有人看不上，觉得太浅。但换个角度想：一个刚接触编程的人，最需要的不是完备的知识体系，而是“我能跑通一行代码”的确定感。菜鸟教程恰好提供了这种确定感。它的“在线实例”按钮点一下就能跳到 Tryit 编辑器，左边改代码右边看效果，不用装 Node.js，不用配环境变量。这个体验在 2015 年前后是相当超前的。

中文技术文档的一块补丁

MDN 当然更权威，但 MDN 的英文原版读起来有门槛，中文翻译又经常滞后或者机翻痕迹明显。菜鸟教程的内容深度比不上 MDN，可它的中文表达是通顺的，例子是贴合中文使用者习惯的。比如它讲正则表达式，用的例子是匹配手机号和邮箱，而不是英文文档里常见的 foo、bar。这种细节让人觉得它是写给“自己人”看的。

还有个挺有意思的现象：很多在职程序员嘴上说菜鸟教程太基础，但真遇到某个不常用的 API 记不清参数顺序时，还是会偷偷去搜“菜鸟教程 某个方法”。因为它页面结构固定，找东西快，不像某些技术博客，关键信息埋在三千字的心路历程中间。

它的局限也很明显

JavaScript 的异步编程、原型链、事件循环这些硬骨头，菜鸟教程讲得确实不够透。ES6 之后的新特性更新速度也一般，有些页面还在用 var 举例。如果你已经过了入门阶段，想深入理解 this 的绑定规则或者 Promise 的实现原理，光靠它是不够的。这时候该翻书翻书，该啃规范啃规范。

但话说回来，哪个教程能包打天下呢？菜鸟教程的定位从来就不是“从入门到精通”，它更像是一本随时能翻的速查手册，外加一个帮你迈出第一步的陪练。我见过不少后端转前端的同事，JavaScript 语法就是靠菜鸟教程过了一遍，然后直接在项目里边写边查 MDN。路径不同，但都走得通。

现在 runoob.com 上的内容比早年丰富多了，加了 Python、Java、SQL 甚至 Linux 命令的板块。界面还是那个界面，朴素得有点过时。可每次看到那个绿色的小图标，还是会想起当年对着屏幕敲下 document.write("Hello World") 然后点运行的那个下午。对很多人来说，菜鸟教程就是那扇门。门不豪华，但推开了，后面是另一个世界。