提高代码可读性的 10 个技巧 _代码

作者：开源中国来源：https://www.oschina.net/translate/具有较强可读性的代码，能帮助你调试程序，不让自己活得太累。
代码可读性是计算机编程领域中普遍存在的问题。这也是我们成为开发者首先要学习的事情之一。本文会详细介绍在编写强可读性代码时最佳实践中最重要的一部分内容。
一
注释和文档

IDE（Integrated Development Environmnet，集成开发环境）在过去数年中已经存在了很长时间。使用 IDE 注释代码比以往容易得多。某些确切的注释标准可以让 IDE 和其它工具以不同的方式来完成注释。
看个示例：

文章插图

我在这里添加到函数定义前的注释可以在使用函数的时候显示出来，甚至在其它文件中使用这个函数也没问题。
下面是另一个示例，关于调用一个第三方库的函数：

文章插图
【提高代码可读性的 10 个技巧】

文章插图

在这些示例中，注释（或文档）的类型是基于 phpDoc 的，使用的 IDE 是 Aptana 。
二
保持一致的缩进

假设你已经知道代码需要缩进。不过值得注意的是，最好保持缩进样式一致。
缩进代码的方式很多，这里最最常见的两种：
风格 1:

文章插图

风格 2:

文章插图

我以前使用的风格 #2，但最近改为 #1 了。但这个问题只是一个偏好的问题。没有“最好”的风格来让每一个人都去遵循。实际上，最好的风格就是一致的风格。如果你是团队的一员，或者你在向某个项目贡献代码，你就应该遵循项目中正在使用的风格。
缩进风格间并不总是会有明显的区别。有时候，不同的规则会产生混淆。比如，在 PEAR 编码标准中，前大括号“{”与控制结构在同一行，但在函数定义中却需要换行。
PEAR 风格:

文章插图

另外，请注意，缩进是用的 4 个空格而不是制表符。
这里是 Wikipedia 中不同缩进风格的示例。
三
避免显而易见的注释

注释代码非常棒；但是，如果注释只是简单的重复就显得多余了。看看这个示例：

文章插图

如果文本是显而易见的，真的没必要在注释里再写一次。
如果你一定要在代码里写点注释，可以把它们合并在一行：

文章插图

四
代码分组

某些任务往往不是几句代码就能解决的，那最好把这些任务代码分为不同的代码段，在它们之间添加一些空行。
下面是一个简单的示例：

文章插图

在每段代码前添加注释可以加强视觉分离效果。
五
保持一致的命名规范

PHP 本身有时候并不遵循一致的命名规范：

strpos() vs. str_split()
imagetypes() vs. image_type_to_extension()

首先，名字应该有单词的边界。下面是两种流行的选择：

驼峰风格（camelCase）：除第一个单词外每个单词的第一个字母都大写。
下划线（underscores）: 在单词间使用下划线分隔，比如：MySQL_real_escape_string() 。

这一点与我前面提到使用不同缩进风格的情况相似。如果项目中已经在使用某个约定，你应该遵循它。另外，某些语言平台往往会有一个特定的命名规范。比如在 JAVA 中，多数代码使用驼峰命名风格，而多数 PHP 程序员使用下划线命名风格。
这些网络也可以混合使得。有些开发者喜欢对过程函数和类使用下划线风格，但对类方法使用驼峰风格：