代码健康

测试覆盖率的最佳实践

我们一直提倡的是:使用代码覆盖率数据来评估风险,并识别测试与预期的差距。 然而,代码覆盖率的价值是一个备受争议且观点两极分化的话题。每次与一群

继续阅读

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

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

继续阅读

到底要不要写注释?怎么写?

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

继续阅读

消除 YAGNI 坏味道

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

继续阅读

使用较长的命名,也会降低可读性

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

继续阅读

通过提交注释和 Issue Report提供上下文。

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

继续阅读

不要痴迷于原始类型

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

继续阅读

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

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

继续阅读

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

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

继续阅读