codelf

本文已经收录进我的 80K+ Star 的 Java 开源项目 JavaGuide： https://github.com/Snailclimb/JavaGuide （「Java学习+面试指南」一份涵盖大部分Java程序员所需要掌握的核心知识） 编程过程中，有太多太多让我们头疼的事情了，比如命名、维护其他人的代码、写测试、与其他人沟通交流等等。就连世界级软件大师 Martin Fowler 大神都说过 CS 领域有两大最难的事情，一是 缓存失效 ，一是 程序命名 （@ https://martinfowler.com/bliki/TwoHardThings.html ）。 今天 Guide 就单独拎出 “ 命名 ” 来聊聊，据说之前在 Quora 网站，由接近 5000 名程序员票选出来的最难的事情就是“命名”。 这篇文章配合我之前发的 《编码 5 分钟，命名 2 小时？史上最全的 Java 命名规范参考！》 这篇文章阅读效果更佳哦！ 为什么需要重视命名？ 好的命名即是注释，别人一看到你的命名就知道你的变量、方法或者类是做什么的！ 好的命名对于其他人（包括你自己）理解你的代码有着很大的帮助！ 简单举个例子说明一下命名的重要性。 《Clean Code》这本书明确指出： 好的代码本身就是注释，我们要尽量规范和美化自己的代码来减少不必要的注释。 若编程语言足够有表达力，就不需要注释

本文已经收录进我的 80K+ Star 的 Java 开源项目 JavaGuide： https://github.com/Snailclimb/JavaGuide （「Java学习+面试指南」一份涵盖大部分Java程序员所需要掌握的核心知识） 编程过程中，有太多太多让我们头疼的事情了，比如命名、维护其他人的代码、写测试、与其他人沟通交流等等。就连世界级软件大师 Martin Fowler 大神都说过 CS 领域有两大最难的事情，一是 缓存失效 ，一是 程序命名 （@ https://martinfowler.com/bliki/TwoHardThings.html ）。 今天 Guide 就单独拎出 “ 命名 ” 来聊聊，据说之前在 Quora 网站，由接近 5000 名程序员票选出来的最难的事情就是“命名”。 这篇文章配合我之前发的 《编码 5 分钟，命名 2 小时？史上最全的 Java 命名规范参考！》 这篇文章阅读效果更佳哦！ 为什么需要重视命名？ 好的命名即是注释，别人一看到你的命名就知道你的变量、方法或者类是做什么的！ 好的命名对于其他人（包括你自己）理解你的代码有着很大的帮助！ 简单举个例子说明一下命名的重要性。 《Clean Code》这本书明确指出： 好的代码本身就是注释，我们要尽量规范和美化自己的代码来减少不必要的注释。 若编程语言足够有表达力，就不需要注释

编程过程中，有太多太多让我们头疼的事情了，比如命名、维护其他人的代码、写测试、与其他人沟通交流等等。就连世界级软件大师 Martin Fowler 大神都说过 CS 领域有两大最难的事情，一是 缓存失效 ，一是 程序命名 （@ https://martinfowler.com/bliki/TwoHardThings.html ）。 今天 楼主 就单独拎出 “ 命名 ” 来聊聊，据说之前在 Quora 网站，由接近 5000 名程序员票选出来的最难的事情就是“命名”。 为什么需要重视命名？ 好的命名即是注释，别人一看到你的命名就知道你的变量、方法或者类是做什么的！ 好的命名对于其他人（包括你自己）理解你的代码有着很大的帮助！ 简单举个例子说明一下命名的重要性。 《Clean Code》这本书明确指出： “好的代码本身就是注释，我们要尽量规范和美化自己的代码来减少不必要的注释。 若编程语言足够有表达力，就不需要注释，尽量通过代码来阐述。 举个例子： 去掉下面复杂的注释，只需要创建一个与注释所言同一事物的函数即可 // check to see if the employee is eligible for full benefits if ((employee.flags & HOURLY_FLAG) && (employee.age > 65 )) 应替换为 if (employee