0222 - 官方文档与第三方教程

技术的官方文档通常有个特点，或者说问题，就是太长太冗余。为了保持权威性和完整性，就像 RFC 一样，必需事无巨细地交待所有内容。这就使得 主要和次要的内容混杂在一起，既淹没了重点，也极大地增加了学习成本。

而与之相对的，是 现代人 的急躁；并 不想真正地学习某东西，而只是想尽快解决眼下的问题。尤其是，老板怪不得员工在瞬间用新技术实现新业务。

两者对比如此强烈，怎么办呢？找捷径。

这种状况和思路，是没有国别和文化差异的。体现在国内就是各种速成班（演化到现在就是网上课程、知识付费），XXX 简明教程，30 天 XXX 实战，给大忙人写的 XXX 入门教程，等等。在国外就是 Head First 系列等等。翻开这些书，绝大多数都是 LJ，通常是官方文档的整段整篇搬抄或翻译，都是在人们焦虑急迫之下的知识快销品。

当然，也不能一棒子打死，有些第三方教程或书籍，确实是很好的。比如，《Cocoa Programming for Mac OS X》，比如阮一峰老师的文章。在我看来，好的教程主要提供两方面的帮助：

• 突出重点
  • 暂时隐藏不太需要知道的东西，降低学习成本
• 提供视角
  • 从经验及实战的视角，重新组织知识

打个比方，官方文档平铺直叙，像个平面，像散落在地上的珍珠。好的教程，可以从中挑选中好的珍珠（重点部分），并用一根线（经验及实践的视角），把它们串起来、从地上拎起来，成为立体的东西。

只是，这样 好的教程，可遇不可求，尤其是知识快销品容易获利，而这样的教程既难制作、又极易被抄袭的时代。于是，更重要的，还是要 增强自己学习的能力。

其实，现在 很多官方文档也提供了不同维度的介绍。既包含平铺化的 API 列表，也有 Excample 提供小而完整的示例，还有 Cookbook 对某些知识点进行深入讲解。善用这些内容，在不同阶段学习对应的东西，再辅以必要的练习，基本就可以很好地入门一些技术。

学习，没有捷径。即便现在貌似抄了近路，将来也是要还的。

---

博客原文：0222 - 官方文档与第三方教程