为什么需要一个样式指南

一个样式指南并不是一份便于阅读并使代码处于理想状态的文档。它在一个项目的生命周期中是一份关键文档，描述了编写代码的方式和采用这样方式的原因。它可能在小项目中显得有些矫枉过正，但却能在保持代码库整洁，提高可扩展性和可维护性上提供诸多便利。 不用多说相信你也可以理解，参与项目的开发者越多，代码样式指南就越显的必要。与之相同，项目的规模越大，代码样式指南也会越加重要。 [Harry Roberts](http://csswizardry.com/) 的 [CSS Guidelines](http://cssguidelin.es/#the-importance-of-a-styleguide) 就非常好: > 样式指南（注意不是视觉风格指南）用于团队是一个很有价值工具： > > * 长时间内便于创建和维护项目 > * 便于不同能力的和专业的开发使用 > * 便于任何时间加入团队的不同开发人员 > * 便于新员工培训 > * 便于开发人员创建代码库