编写高质量代码的技巧

7,265 阅读5分钟

1.从计划开始

编写更好代码的最好方法之一是从计划开始。在开始编码之前,请花几分钟时间思考一下你希望代码做什么。

不要认为你知道需要做什么而跳到编写代码中。花点时间真正了解手头的问题。

  • 输入和输出是什么?
  • 预期结果是什么?
  • 从一个到另一个需要采取哪些步骤?
  • 你需要什么数据结构?
  • 有什么边缘案例需要考虑吗?

清楚地了解需要做什么,使你能够将你的想法转化为具体的计划。即使你开发的高级程序结构并不完美,你也会发现生成的代码更容易阅读,扩展代码的复杂性更容易管理。

2.写出有意义的变量和函数名称

写得很好的代码的标志之一是它易于阅读和理解。让你的代码易于阅读的很大一部分是使用有意义的变量和函数名。

为事物选择好名声很难。但即使在网络开发中也是如此。当人们试图理解你的代码时,你的变量和函数名称通常是人们首先看到的。

变量和函数名称应为:

  • 描述性。
  • 易于记忆和发音。
  • 与代码中的其他名称一致。

要实现这一点,你应该:

  • 使用描述性名称。
  • 避免使用单个字母名称,除非上下文中的意思非常清楚。
  • 避免使用神奇的数字。
  • 决定命名惯例,然后坚持下去。
  • 一如既往,评论你的代码。

当你为事物挑选名字时,问自己以下问题:

  • 这个变量或函数是做什么用的?
  • 它的名字描述了它的目的吗?
  • 记住我什么时候发音容易吗?
  • 它与代码中的其他名称一致吗?

如果你无法轻松回答所有这些问题,那么选择一个不同的名字可能是一个好主意。

3.编写小型模块化函数

较小的功能更容易测试,更容易调试,也更容易重用。它们还使你的代码更具可读性,因为每个函数的目的都很清楚。

重要的是要明白,代码模块化不是关于在代码中禁欲地追求极简主义。这是关于从你花在解决问题上的时间中受益。

要实现这一点,你应该:

  • 通过赋予他们单一的责任来保持功能小规模
  • 描述性地命名你的函数
  • 避免副作用
  • 明智地使用参数

4.注释

注释是提高代码可读性的好方法。使用注释来解释你的代码在做什么以及你为什么要这样做。

一个常见的惯例是使用TODO评论为自己留下需要做的事情的笔记:

// TODO: Implement login functionality

另一个常见的惯例是使用FIXME评论为自己留下需要修复的事情的笔记:

// FIXME: This code is not working properly

这是跟踪需要做什么的有用方法,它还使其他人很容易看到需要做什么。

重要的是要记住,注释应该用于提高代码的可读性,而不是使其更难理解。如果你发现自己写的评论比它正在评论的代码长,这表明你的代码不可读,应该重构。

5.使用空格提高可读性

除了缩进代码外,你还可以使用空格来提高其可读性。通过在代码行之间添加额外的间距,将使你的代码更容易扫描和理解。当你查看大块代码时,这特别有帮助。

6.DRY原则

DRY原理是良好编码最重要的原则之一。尽可能避免复制代码很重要。这节省了你的时间,因为你只解决问题一次,并且只需要在其他因素发生变化时更改解决方案的一个实现。

发生故障时,你只需要修复一个实现,因此DRY代码更容易维护,并且不太容易出错。

7.编写SOLID代码

SOLID是一个首字母缩略词,引用了五个关键的软件设计原则,由Robert C创造。Martin,敏捷软件开发宣言的创始人,也是Clean Code的作者。

SOLID的五项设计原则是:

  • Single responsibility 原则。
  • Open/closed 原则。
  • Liskov substitution 原则。
  • Interface segregation 原则。
  • Dependency inversion 原则。

你不需要记住这些原则,但它们值得注意。当你开始编写更好的代码时,你可能会发现自己自然地遵循这些原则。

8.不要重新发明轮子

良好编码最重要的原则之一是不要重新发明车轮。这意味着你应该尽可能使用现有的库、工具和框架,而不是从头开始编写自己的代码。

遵循这一原则有很多原因。首先,它为你节省了时间。你不必编写已经编写的代码。其次,它减少了你必须维护的代码量。第三,它增加了其他人发现并修复现有代码中任何错误的可能性。

当然,这条规则也有例外。如果你需要一些还不存在的东西,你必须自己创造它。但一般来说,最好尽可能重用现有代码。

开启掘金成长之旅!这是我参与「掘金日新计划 · 2 月更文挑战」的第 4 天,点击查看活动详情