关于如何给变量函数命名

Posted 红茶知道

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了关于如何给变量函数命名相关的知识,希望对你有一定的参考价值。

一位google创作语言的工程师讲的非常好,详见 https://mp.weixin.qq.com/s/xRB5fy4KkZN9ziJUrpG8PQ 我会在下面总结一下

变量函数命名是基本功,不要忽略这些细节,在大公司里写代码可不是能实现基本功能就行了.

 

回到正题,总结:

1,变量的命名不要带上其数据类型中就已经说明的信息 如List<String> strings 就很好,不要写成List<String> stringList

2,函数的命名不要带上其参数列表中已经说明的信息, 如sortEventsUsingComparator(List<Event> events,Comparator<Event> comparator)要改成

   sort(List<Event> events, Comparator<Event> comparator)

3,变量或函数命名时不要带上删除后也不会引起歧义的单词(即多余的单词),如finalBattleMostDangerousBossMonster 写成boss也不会引起歧义,那么就写成boss就行了,

   事实上一个项目刚开始时变量函数命名先保证当时不引起歧义就行,如果随着项目的深入会引起歧义时再重构就好了,如果一开始就写的很复杂,那后面一般也不会去改了.

4,变量或函数命名时不要带上可以从上下文中获取到的信息 如在一个Student类中 不要写 int studentId 直接写 int id就行 ,

    实际上, 一个命名嵌套的层次越多, 它就有更多的相关的上下文,也就更简短。

以上是关于关于如何给变量函数命名的主要内容,如果未能解决你的问题,请参考以下文章

C语言命名规范

关于JavaBean命名

关于 global nonlocal 用法

C++ 项目相关知识命名空间

C++问题:关于匿名命名空间

关于C++基础的一些“碎碎念”