代码整洁之道

Posted 响马

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了代码整洁之道相关的知识,希望对你有一定的参考价值。

一、有意义的命名

  • 名副其实
  • 避免误导
  • 使用统一标记风格(Pascal或Camel)
  • 别用双关语
  • 添加有意义的语境(上下文)

二、函数

  • 短小
  • 只做一件事
  • 名称有意义,使用描述性名称。
  • 合理使用switch和if
  • 别重复自己,多提取公共函数

三、注释

  • 最好的注释是没有注释
  • 最好的注释是有意义的命名。
  • 好注释描述问题
  • 坏注释胡言乱语
  • 及时更新注释别出现上条问题。
  • 坏注释不如无注释,不能保证注释新鲜,删除注释。

四、格式

  • 代码排版上下有间隙
  • 代码左右长度不要超过屏幕宽。

五、错误处理

  • 错误时抛出异常
  • 先写try-catch-finally语言
  • 别返回null,别传递null

六、边界定义

  • 不重复造轮子,合理使用第三方代码
  • 系统添加防腐层

七、单元测试

  • 只有通过单元测试的代码才是正在Clean
  • 上述6条只是表面干净

八、类

  • 类应该短小
  • 单一权责
  • 内聚

九、系统

  • AOP
  • ASP
  • DI和IOC

以上是关于代码整洁之道的主要内容,如果未能解决你的问题,请参考以下文章

代码整洁之道读书笔记

《代码整洁之道》读后感

TypeScript 代码整洁之道

代码整洁之道

代码整洁之道

《代码整洁之道》学习笔记