PIE原则——编程要表达出意图

PIE

英文：Program Intently and Expressively

中文：编程要表达出意图

是什么

在写代码时，明确表达意图十分重要，这与写诗、写随笔、写博客和写信是一个道理。

这是因为代码是写给人看的，而不是写给编译器看的。

因此，在写代码的时候要在表达上多花心思，将软件运行方式直接地传送给阅读代码的人。

为什么

代码是我们正确、完整地了解软件运行方式的唯一线索。

软件开发过程中虽然会创建诸多文档，但这些文档并不能帮助我们正确认识软件是如何运行的。

需求定义文档只描述了需要什么东西。

基本设计文档只描述了用什么样的软件来实现需求。

详细设计文档只描述了成品软件是什么样的结构，详细设计文档虽然与代码最接近，但代码是动态变更的，而详细设计文档往往做不到同步，更何况并非每个项目都有详细设计文档。所以说详细设计文档并不是百分百存在且百分百有用的。

到头来我们只能通过阅读代码来掌握软件的运行情况。因此，编写可读性高的代码，用代码表达意图是唯一可取的方法。

怎么做

把提高代码可读性作为第一要务。重视代码的可读性，而不是代码的易写性。

读代码的次数远比写代码的次数多。“读代码的效率”应优先于“写代码的效率”。“读代码的效率”同样优先于“执行代码的效率”，因为如果代码的可读性高，提高代码的执行效率也会变得容易一些。

将代码的可读性放在第一位，就意味不能为了炫耀才华而写一些让人难懂的代码。刚学会新技术时，人们容易落入陷阱，明知学会的新技术用不上还炫耀一下。不能让人读懂的代码不是好代码，只有能够向读者准确表达意图的代码，才是好代码。