代码即文档？

又一个“理想和现实”

可以肯定的是，“代码即文档”一定是一种极其理想的状态。

当我们假定前提为：

`Code is doc` > `Code + comments` ≈ `Code + docs` > `Code`

我们可以发现，真正的“代码即文档”的践行，是对于编程能力（项目结构、命名及语义风格、设计模式、合作严格审阅、易读性、高效性、简洁性）有着非常高的要求和挑战的，而往往极其难以有人（团队）能真正的做到以上这些的。

为什么我们经常接手的都是无文档无注释的 shit mountain code 项目呢？首先绝大多数程序员连注释都懒得写（例如函数签名注释都懒得写），你更别要求他能给你留下文档了。而更为重要的一点可能则在于：你的编程能力越强，代码即文档践行的越优秀，在现实高压社会环境下，你被新鲜出炉的年轻人代替的概率也会极大提高的（笑）。