Coding,命名是个技术活
来吧
日常编码少不了的事情就是给代码命名,代码中命名的重要性在项目前期不会有太大感受,因为是边做边命名,代码天天见,自然会加深记忆。但到了后期上线后半年一年后,再回过头看的时候,我擦,这个变量是啥意思?这个方法不对呀,不是更新用户状态的吗? 接下来就是各种吐槽,谁写的代码,这么烂,翻一下提交日志,哦?我写的,赶紧悄悄的改过来。
经常性我们吐槽别人的代码烂,那么你是如何定义你认为的烂代码,它们烂在哪里 ?
代码究竟烂在哪里
这个问题说的具体点,可能经常我们在没理清业务逻辑的情况下去直接看别人的代码,相当于通过代码反推业务逻辑,别人的命名、编程思维跟自己的习惯不一致,需要时间去消化理解他的逻辑和习惯,然后加上代码排版乱七八糟,一堆 if else
,还掺杂着各种奇怪的命名,魔鬼数字,OMG,简直不要太爽。以上综合起来,大概就是大家眼中认为的烂代码吧。
简要总结下:
- 自身原因,业务并未完全理解清楚,直接上手看代码
这里是建议先搞懂业务逻辑和相关的实体或数据库表,最好是自己简要画出流程图或时序图辅助理解代码,展开说的话比较多,后面有机会单独写一篇吧
- 代码风格不规范
体现在各种接口、方法、变量的命名不规范,代码格式排版混乱,过长方法,无注释或不详细等,注释这块最坑的不是没有注释,而是错误的注释。自己脑补下画面
- 代码逻辑混乱
体现在代码逻辑不清楚、冗余代码、废弃方法、深层的嵌套等,怎么优化,也值得单独写几篇
可以看到命名在里面占有一席之地,那么如何做好代码中的命名,且往下看。
好的命名,看这里
先给出结论,一个好的命名最最最关键的一点,见名知意,见名知意,见名知意,重要的内容重复三遍,并加个底色。
不要怕长
我工作中碰到不少人有个命名习惯,我称为半命名方式,看个例子,定义一个业务需求的实体类,正常见名知意的命名是这样的BusinessRequirement
,但是,他们觉得这样太长,他们会这样
BusRequi
、(各省一半)
BusinessReq
(后面省一半)
BusinessXq
(一半英文、一半拼音,洋不洋气)
这样的命名完全不具有可读性,还容易产生歧义。所以,不要怕长,能让人和有道词典读懂是前提。
看个springboot中的命名
SpringApplicationJsonEnvironmentPostProcessor
长吗?但肯定能读懂对吧。
但是有一类是可以简化的,就是行业内大家公认的术语简称,比如你想整个ip工具类,那么你可以这样命名IpUtil
,就没必要整成这样InternetProtocolUtil
,因为Ip这个词在业内大家都懂,就可以简写。
准确
准确就是命名要符合当下的业务场景,比如我老早之前做的考试类项目中有个题目实体,同事采用的命名是Problem
,显然放这里是不合适的,最后纠正为Question
。要做到准确,还是比较考验英文功底的。
具体
具体就是能正确表达变量或类所指向的代码含义,例如我们定义了一个代表软件版本号的数组,可能会这样定义
int[] array = new int[] {1,2,3,4,5};
数组倒是能看懂,但是单看这一行代码并不能搞清楚干什么用,放在具体的代码逻辑里结合上下文代码,倒也能推导出来数组中定义的具体是什么,但是增加的阅读代码的难度,好一点的当然是下面这样
int[] versionNumberArray = new int[] {1,2,3,4,5};
说清楚具体含义,表示的是什么数组,而不是只抽象的表达个数组的概念。
额外补充一点
我见过一个项目从代码到数据库整体命名都是拼音简写形式,说实话拼音简写对业务不熟悉人来说很难识别,而且时间一长完全是懵逼的,完全得靠猜。
拿上面的业务需求来说拼音整出来Ywxq
,拼音组合可以有很多种解读。项目得以持续维护的关键是他们有详细的字典说明文档,实际上就是上篇文章说的公司或团队有一套自己的标准就行
。
但是可想而知仍然很痛苦,除非是个别领域内的专业词汇,英文很难表达,可以尝试拼音解决,其他情况还是尽量用英文命名。
总结
好的命名就是做到见名知意,具体遵循以下几点:
1、不要怕长,专业术语行业内有简称,可用简称
2、用词准确
3、表达具体
4、尽量使用英文
5、上面没提到的一点,公司有规范,优先符合公司规范
未入行之前,很多人总是好奇,英文基础对编码到底有没有影响,到底有多大,这里就可以看到,是有影响的,起码命名的时候有障碍,需要借助有道词典或 code if
这样的工具。
而且越往后英语的重要性就愈加明显,比如你可以直接读一手英文资料、文献等。
最后
写完了老感觉烂代码
这个词用的很不好,奈何词穷,先这么着吧。