代码里的命名规则:错误的和正确的对比
这篇讲的是代码命名中容易被忽视的关键细节。作者从“代码即文档”的理念出发,指出好的命名能让代码自我解释,而糟糕的命名则会埋下理解的坑。 文章通过七组具体的正反案例,直观对比了命名时的常见陷阱与推荐实践。比如,变量 `d` 的意图全靠注释,而 `elapsedTimeInDays` 一目了然;使用 `customerList` 命名一个数组会误导读者,改为 `customers` 则清晰准确。核心差异在于:好的命名能准确揭示意图、避免歧义、长度适中、遵循团队规范、概念一致,并贴合业务领域与上下文。 作者强调,这不仅仅是风格偏好,而是关乎代码可维护性和团队协作效率的根本。通过遵循这些具体的命名原则,程序员可以让代码在“无注释”的情况下也能被轻松读懂,从而真正实现高效沟通。