[译]Java 15条变量&方法命名的最佳实践
2016-10-18 10:42
351 查看
不同的代码段采用不同的命名长度。通常来说,循环计数器(loop counters)采用1位的单字符来命名,循环判断变量(condition/loop variables)采用1个单词来命名,方法采用1-2个单词命名,类采用2-3个单词命名,全局变量采用3-4个单词命名。
对变量采用具体的命名(specific names)方式,”value”, “equals”, “data”在任何情况下都不是一种有效的命名方式。
采用有意义的命名(meaningful names)。变量的名字必须准确反映它的含义和内容。
不要用 o_, obj_, m_ 等前缀命名。变量不需要前缀标签来表示自己是一个变量。
遵循公司的变量命名规则,在项目中坚持使用同一种变量命名方式。例如txtUserName, lblUserName, cmbSchoolType等,否则会对可读性造成影响,而且会令查找/替换工具(find/replace tools)不可用。
遵循当前语言的变量命名规则,不要不统一(inconsistently)地使用大/小写字母。例如:userName, UserName, USER_NAME, m_userName, username, …。
以Java为例:
类名使用驼峰命名法(Camel Case):VelocityResponseWriter
包名使用小写:com.company.project.ui
变量使用首字母小写的驼峰命名法(Mixed Case):studentName
常量使用大写:MAX_PARAMETER_COUNT = 100
枚举类(enum class)采用驼峰命名法,枚举值(enum values)采用大写。
除了常量和枚举值以外,不要使用下划线’_’
在同一个类不同的场景(contexts)中不要复用变量名。例如在方法、初始化方法和类中。这样做可以提高可读性和可维护性。
不要对不同使用目的的变量使用同一个变量名,而是赋予它们不同的名字。这同样对保持可读性和可维护性很重要。
变量名不要使用非ASCII字符(non-ASCII chars)。这样做可能会在跨平台使用时产生问题。
不要使用过长的变量名(例如50个字符)。过长的变量名会导致代码丑陋(ugly)和难以阅读(hard-to-read),还可能因为字符限制在某些编译器上存在兼容性问题。
仅使用一种自然语言(natural language)来命名变量。例如,同时使用德语和英语来命名变量会导致(理解)不一致和降低可读性。
使用有意义的方法名。方法名必须准确表达该方法的行为,在多数情况下以动词(verb)开头。(例如:createPasswordHash)
遵循公司的方法命名规则,在项目中坚持使用同一种方法命名方式。例如 getTxtUserName(), getLblUserName(), isStudentApproved(),否则会对可读性造成影响,而且会令查找/替换工具不可用。
遵循当前语言的变量命名规则,不要不统一地使用大/小写字母。例如:getUserName, GetUserName, getusername, …。
以Java为例:
方法使用首字母小写的驼峰命名法:getStudentSchoolType
方法参数使用首字母小写的驼峰命名法:setSchoolName(String schoolName)
使用有意义的方法参数命名,这样做可以在没有文档的情况下尽量做到“自解释(documentate itself)”
对变量采用具体的命名(specific names)方式,”value”, “equals”, “data”在任何情况下都不是一种有效的命名方式。
采用有意义的命名(meaningful names)。变量的名字必须准确反映它的含义和内容。
不要用 o_, obj_, m_ 等前缀命名。变量不需要前缀标签来表示自己是一个变量。
遵循公司的变量命名规则,在项目中坚持使用同一种变量命名方式。例如txtUserName, lblUserName, cmbSchoolType等,否则会对可读性造成影响,而且会令查找/替换工具(find/replace tools)不可用。
遵循当前语言的变量命名规则,不要不统一(inconsistently)地使用大/小写字母。例如:userName, UserName, USER_NAME, m_userName, username, …。
以Java为例:
类名使用驼峰命名法(Camel Case):VelocityResponseWriter
包名使用小写:com.company.project.ui
变量使用首字母小写的驼峰命名法(Mixed Case):studentName
常量使用大写:MAX_PARAMETER_COUNT = 100
枚举类(enum class)采用驼峰命名法,枚举值(enum values)采用大写。
除了常量和枚举值以外,不要使用下划线’_’
在同一个类不同的场景(contexts)中不要复用变量名。例如在方法、初始化方法和类中。这样做可以提高可读性和可维护性。
不要对不同使用目的的变量使用同一个变量名,而是赋予它们不同的名字。这同样对保持可读性和可维护性很重要。
变量名不要使用非ASCII字符(non-ASCII chars)。这样做可能会在跨平台使用时产生问题。
不要使用过长的变量名(例如50个字符)。过长的变量名会导致代码丑陋(ugly)和难以阅读(hard-to-read),还可能因为字符限制在某些编译器上存在兼容性问题。
仅使用一种自然语言(natural language)来命名变量。例如,同时使用德语和英语来命名变量会导致(理解)不一致和降低可读性。
使用有意义的方法名。方法名必须准确表达该方法的行为,在多数情况下以动词(verb)开头。(例如:createPasswordHash)
遵循公司的方法命名规则,在项目中坚持使用同一种方法命名方式。例如 getTxtUserName(), getLblUserName(), isStudentApproved(),否则会对可读性造成影响,而且会令查找/替换工具不可用。
遵循当前语言的变量命名规则,不要不统一地使用大/小写字母。例如:getUserName, GetUserName, getusername, …。
以Java为例:
方法使用首字母小写的驼峰命名法:getStudentSchoolType
方法参数使用首字母小写的驼峰命名法:setSchoolName(String schoolName)
使用有意义的方法参数命名,这样做可以在没有文档的情况下尽量做到“自解释(documentate itself)”
相关文章推荐
- 15条变量&方法命名的最佳实践【转】
- python基础===15条变量&方法命名的最佳实践
- Atitit. 软件设计 模式 变量 方法 命名最佳实践 vp820 attilax总结命名表大全
- Atitit. 软件设计 模式 变量 方法 命名最佳实践 vp820 attilax总结命名表大全
- 方法和变量命名的最佳实践
- 变量和方法命名的最佳实践
- Atitit. 软件设计 模式 变量 方法 命名最佳实践 vp820 attilax总结命名表大全
- 15 个变量和方法命名的最佳实践
- 15 个变量和方法命名的最佳实践
- 变量和方法命名的最佳实践
- Java对象初始化步骤&&子类继承父类后变量与方法调用情况
- java标识符标识符就是用于给 Java 程序中变量、类、方法等命名的符号。
- Java入门基础之常规的命名方法和变量的值及其引用
- java 类,方法,变量的说明符   pr…
- (2)JAVA 变量 作用域 main方法 命名规范
- java中类名,方法,变量,包名等大小写命名规范
- Java接口中的变量和方法默认的类型<转>
- Java语言中,包名、类名、接口名、方法名、变量名,以及常量名的命名有何规范的命名习惯
- JAVA学习.JAVA对象构建内存理解&静态方法和变量的理解和使用.
- 【Java高并发最佳实践】ConcurrentHashMap的遍历方法