给亲推荐一篇阿里巴巴高级开发工程师竹涧分享的关于代码整洁之道的一篇文，希望对你有所帮助 。
Any fool can write code that a computer can understand. Good programmers write code that humans can understand.普通的工程师堆砌代码，优秀的工程师优雅代码，卓越的工程师简化代码 。如何写出优雅整洁易懂的代码是一门学问，也是软件工程实践里重要的一环 。笔者推荐三本经典的书籍《代码整洁之道 》、《编写可读代码的艺术》、《重构:改善既有代码的设计》，下文重点将从注释、命名、方法、异常、单元测试等多个方面总结了一些代码整洁最佳实践，大部分是笔者总结于以上三本书中的精华，也有部分是笔者工程实践的总结 。篇幅有限，本文将总结性给出一些实践建议，后续会有文章来给出一些代码整洁之道的事例 。
注释
不要给不好的名字加注释，一个好的名字比好的注释更重要不要“拐杖注释”，好代码 > 坏代码 + 好注释在文件/类级别使用全局注释来解释所有部分如何工作一定要给常量加注释团队统一定义标记TODO 待处理的问题FIXME 已知有问题的代码HACK 不得不采用的粗糙的解决方案
在注释中用精心挑选的输入输出例子进行说明注释应该声明代码的高层次意图，而非明显的细节不要在代码中加入代码的著作信息，git可以干的事情不要交给代码源代码中的html注释是一种厌物, 增加阅读难度注释一定要描述离它最近的代码注释一定要与代码对应公共api需要添加注释，其它代码谨慎使用注释典型的烂注释不恰当的信息废弃的注释冗余注释糟糕的注释注释掉的代码
唯一真正好的注释是你想办法不去写的注释不要有循规式注释，比如setter/getter注释不要添加日志式注释，比如修改时间等信息（git可以做的事情）注释一定是表达代码之外的东西，代码可以包含的内容，注释中一定不要出现如果有必要注释，请注释意图（why），而不要去注释实现（how)，大家都会看代码适当添加警示注释
命名
尽可能使用标准命名方法，比如设计模式，通用学术名词等命名要找更有表现力的词使用更专业的词，比如不用get而使用fetch或者download避免空泛的名字，像tmp使用具体的名字来细致的描述事物给变量名带上重要的细节，比如加上单位ms等为作用域大的名字采用更长的名字，作用域小的使用短名字变量类型为布尔值表达加上is，has，can，should这样的词会更明确
【如何写出简洁、高效的代码？】变量名称长短应该与其作用域对应别害怕长名称，长而具有描述性的名称比短而令人费解的名称好函数名称应该说明副作用，名称应该表达函数，变量或类的一切信息，请不要掩盖副作用，比如CreateAndReturnXXX方法
函数不应该有100行那么长，20行封顶最好if else while等控制语句其中代码块应该只有一行，也就是一个函数调用语句函数的锁进层次不应该多于两层一个函数只做一件事，一个函数不应该能抽象出另外一个函数
某个公共函数调用的私有函数紧随其后最理想的参数是零参数，最长不要超过三个入参，尽量不要输出参数如果函数传入三个及以上参数最好将其抽象为类标识参数十分丑陋，向函数传入布尔值用于区分不同业务的做法很丑陋，应该拆分为多个函数
别返回null值，抛出异常或者返回特殊对象，尽量避免NPE别传入null值异常与错误
抽离try catch包含的代码块，其中代码块抽象为一个函数抛出的每个异常，都应当提供足够的环境说明，已便判断错误的来源与处所不要将系统错误归咎于偶然事件并发
分离并发相关代码与其它代码严格限制对可能被共享的数据的访问避免使用一个共享对象的多个同步方法保持同步区域微小，尽可能少设计临界区单元测试
不要怕单元测试的方法名字太长或者繁琐，测试函数的名称就像注释不要追求太高的测试覆盖率，测试代码前面90%通常比后面10%花的时间少使用最简单的并且能够完整运用代码的测试输入给测试函数取一个完整性的描述性名字，比如 Test _测试代码与生产代码一样重要如果测试代码不能保证整洁，你就会很快失去他们每个测试一个断言，单个测试中断言数量应该最小化也就是一个断言FIRST原则快速 Fast独立 Independent 测试应该相互独立可重复 Repeatable 测试应当在任何环境中重复通过自足验证 Self-Validating 测试应该有布尔值输出及时 Timely 最好的方式是TDD
代码结构
代码行长度控制在100-120个字符可能用大多数为200行，最长500行的单个文件构造出色的系统关系密切的代码应该相互靠近变量声明应该靠近其使用位置若某个函数调用了另外一个，应该把他们放在一起，而且调用者应该放在被调用者上面自上向下展示函数调用依赖顺序
推荐阅读
- 印堂纹的面相图解 印堂纹面相如何看
- 印堂发黑意味着什么 印堂发黑的人命运如何
- 如何清蒸桂鱼好吃又简单 清蒸桂鱼的做法大全
- 女生下巴尖代表什么 下巴尖面相的女人命运如何
- 如何评价MISIA在《歌手·当打之年》第3期演唱的《向着明天》？
- 解析面相额头如何看运势 通过额头面相看命运
- 女人脖子上长痣代表什么 脖子长痣的女人运势如何
- 定妆粉如何使用方法视频 定妆粉如何使用
- 如何做陪玩兼职 如何成功做兼职
- 如何准确快速搜索文献