最近重新阅读了《代码整洁之道》这本书，有了新的感悟。

有意义的命名

好的命名应该能表达意图：

// 不好的命名
int d; // 过去的天数

// 好的命名
int elapsedTimeInDays;

函数应该短小

函数只做一件事，做好这件事，只做这一件事。

// ❌ 不好的做法
function processData(data) {
  // 验证数据
  // 处理数据
  // 保存数据
  // 发送通知
}

// ✅ 好的做法
function processData(data) {
  if (!validate(data)) return;
  const result = transform(data);
  save(result);
  notify(result);
}

注释是不得已的手段

好的代码本身就是文档。与其写注释解释糟糕的代码，不如把代码写清楚。