插件窝 干货文章 干净代码的黄金法则:函数应该做一件事

干净代码的黄金法则:函数应该做一件事

li 函数 代码 strong 38    来源:    2024-10-19

在软件工程的世界里,有一个原则高于其他原则:函数应该做一件事,并且做好它。这个概念通常称为单一职责原则 (srp),是干净、可维护代码的基石。

为什么这很重要?

当函数具有单一职责时:

  1. 它们更容易理解和推理
  2. 测试变得更简单、更有针对性
  3. 重构风险更小,更直接
  4. 代码可重用性显着提高
  5. 调试不再那么令人头疼

让我们看一个例子来说明这一原理的实际应用。

不良实践:多重职责功能

考虑这个向客户发送电子邮件的功能:


function emailclients(clients) {
  clients.foreach(client => {
    const clientrecord = database.lookup(client);
    if (clientrecord.isactive()) {
      email(client);
    }
  });
}


这个函数正在做几件事:

  1. 迭代客户端
  2. 查询每个客户的记录
  3. 检查客户端是否处于活动状态
  4. 向活跃客户发送电子邮件

虽然将所有这些都放在一个地方似乎很有效,但它使该功能更难以维护和测试。

良好实践:单一职责职能

现在,让我们将其重构为更小、更集中的函数:


function emailActiveClients(clients) {
  clients.filter(isActiveClient).forEach(email);
}

function isActiveClient(client) {
  const clientRecord = database.lookup(client);
  return clientRecord.isActive();
}


在此重构版本中:

  • emailactiveclients 专注于向活跃客户发送电子邮件的高级任务
  • isactiveclient 处理确定客户端是否处于活动状态的细节

这种关注点分离使得每个函数更容易理解、测试,并且可能在代码库的其他部分中重用。

这种方法的好处

  1. 可读性:代码讲述了一个清晰的故事。任何阅读 emailactiveclients 的人都可以快速理解其目的,而无需陷入实现细节的困境。
  2. 可测试性:您现在可以轻松地为电子邮件发送逻辑和客户端活动检查编写单独的测试。
  3. 灵活性:如果需要更改活跃客户端的确定方式,只需修改 isactiveclient 函数即可。
  4. 可重用性:如果需要,isactiveclient 函数现在可以在代码库的其他地方使用。

结论

接受“函数应该做一件事”的原则一开始可能会感觉很冗长,但从长远来看,它对代码库的可维护性和团队的生产力的好处是巨大的。当你编写和重构代码时,总是问自己:“这个函数是否不止做一件事?”如果答案是肯定的,那么是时候分解它了!

请记住,干净的代码不仅仅是让事情正常运转,而是让事情优雅且可持续地运转。快乐编码!