代码健康

代码健康(10):包含尊重的CR,才是有用的CR

虽然代码评审被认为是提高软件项目质量的一个有价值的工具。但是,如果反馈评论被认为描述不清晰,或者是过于苛刻,都可能会产生不良后果,如:慢吞吞

继续阅读

代码健康(9):减少嵌套, 减少复杂性

嵌套过深的代码对可读性有害,而且容易出错。 而通过卫语句来检查某一条件,如果不满足就直接快速失败。 卫语句将计算逻辑与错误逻辑分离。通过消除错误

继续阅读

代码健康(7):注释并不总是好事儿

要写注释,还是不用呢? 当阅读代码时, 没有什么比良好的注释内容更给力的了。 然而, 注释并不总是好事儿。 在哪些情况下,不应该写注释,而是应该重构 假

继续阅读

代码健康(6):消除 YAGNI 坏味道

消除 YAGNI 坏味道 软件开发的大部分成本是维护成本。减少维护成本的一个方法是:“只在当你真正需要它时,才去编写它”。也就是所谓的 “你不需要它( You Aren’t Gonna

继续阅读

代码健康(5):使用较长的命名,也会降低可读性

小心使用过长的命名 创建长标识符很容易被带飞。虽然较长的命名常常让代码更加具有可读性,但是,如果名字过长,也能降低可读性。在GitHub和其它

继续阅读

代码健康(4):使用较长的命名,也可能降低可读性

利用“ commit message ”和“ issue ”提供上下文 阅读其他工程师的代码有时会感觉像是在考古,其中可能充满了难以破译的,奇怪(甚至令人瞠目结舌)的描述。**写代码

继续阅读

代码健康(3):不要痴迷于原始类型?

不要痴迷于原始类型 编程语言提供基本类型,如 int ,string 和 map ,这些类型在许多场景下都被用到,例如,利用 string 保存人名,或者网页URL等等。 然而

继续阅读

代码健康(2):接口设计,要让其很难被误用

这是《Effective C++》中的第18条原则。 我们都在试图避免代码中的错误。 那么,如何避免调用者以错误的方式调用了你的这些代码呢? 让你接

继续阅读

代码健康(1):什么是易理解的代码?

什么是代码健康 良好的编码实践包含许多方面,并不是任何代码问题都能由检查工具发现。 例如,编写具有可读性和可维护性的代码,不仅仅是编写好的测试,

继续阅读