欢迎光临南京典乐信息科技有限公司
24小时:400-025-1949
繁體版
手机版
公司新闻
行业新闻
当前位置:首页 » 新闻中心 » 公司新闻

代码可读性来说是最重要的

发表日期:2017-11-13 16:40:22文章编辑:浏览次数:300 标签:公司新闻    

我想特别强调的是变量的命名,这点对代码可读性来说是最重要的,当我看到一段代码中出现了不一致的命名规则时,我会很感觉看代码的效率很低,因为我要去想该变量会对象的含义、目的等等是什么。我的原则是,变量名必须体现业务逻辑含义。比如控件命名可以为:userNameTextBox,passwordTextBo ...

我想特别强调的是变量的命名,这点对代码可读性来说是最重要的,
当我看到一段代码中出现了不一致的命名规则时,我会很感觉看代码的效率很低,因为我要去想该变量会对象的含义、目的等等是什么。
我的原则是,变量名必须体现业务逻辑含义。比如控件命名可以为:
userNameTextBox,passwordTextBox,即业务逻辑名+控件名,并且命名风格必须是camel命名法(.NET下的私有成员的命名规范);

上升到更高以及的命名法则就是:业务逻辑名+类型名,当然这里的类型一般不包括基本数据类型,比如int,double等。

下面进行举例:
1:比如现在有一个类型叫Category,那么当我们写parentCategorychildCategory时就已经知道了亮点:1)它们在业务上是父子关系;2)在类型上都是Category类型;如果我们命名为:cateParent,cateChild看似很好,但除非你全部统一用这样的命名风格。但要知道并不是每个类型的缩写都是很容易看懂的。比如有一个类型的名称很长:SmartProjectStatus,那么按照你前面的命名方式的话可能是:spsClosed,表示一个已关闭的SmartProjectStatus。这样的命名太难以理解了。我们应该始终要用统一的命名方式来命名,这点可以说可以看出一个程序员是否有良好的编程信念的关键点。

2:前面有说到对于基本数据类型不必遵循这个规则,直接用业务逻辑名即可,因为基础数据类型往往不需要额外说明。比如:startDate,endDate,startIndex,endIndex,totalCount,maxFailedCount,等等。当我们看到这些变量时,首先我们会很清楚这些变量的业务含义,同时也很清楚他们的类型。像引用到的例子中的命名方式:

for (int i = 0; i < arguments.Length; i++)实在不太好,

试想一下一个函数中出现了i,j,k,等循环变量,也许刚写代码时能记住这些变量的业务意义,在那个循环里,但是别人或者代码的作者过了一段时间后旺旺会忘记,然后他们看代码时一定会去看一个这个变量是在哪个循环里,因为他要知道该循环变量的业务含义。

但是如果你在一开始就用类似下面的命名方法:
for (int argumentIndex = 0; argumentIndex < arguments.Length; argumentIndex++)
那么你就很清楚argumentIndex的业务含义了,他表示某个参数索引。

我说了这么多,想强调的是:变量要以明确告诉看代码的人业务含义为目标,这是最重要的也是必须要严格遵守的约定。否则新人无法看懂你的代码;
至于代码规范,比如大小写,下划线等,只要统一即可,比如public,protected,internal的变量或属性或方法统一用Pascal命名法,private的则统一用camel命名法;这些很容易做到。
但对于初级程序员或者说没有自律意识的程序员来说实在太难做到了。

总之,我希望大家清楚命名的目的,规范的目的;遵守不遵守之间就能彻底地体现你的专业性!

专业服务:南京建站,南京网站制作,南京网站设计,南京网站制作公司

咨询电话:400-025-1949(7*24小时在线服务)

咨询QQ:260193150

公司网址:www.icanpk.com

本文地址:http://www.025app.com/news/detail_174.html

相关新闻

两Q友非法入侵他人网站推广赌博公司 南京医药官网等中招

两人利用木马信息侵入南京医药、世纪华联等单位官网串改链接帮助…

日期:2020-04-28 浏览次数:298

3月8日后南京长江二桥车道封闭维护 为期22天

为保障路桥结构和交通通行安全,经市政府批准,南京长江第二大桥…

日期:2020-03-08 浏览次数:281

怎样解决企业网站没有客户咨询的问题?

我们都知道如今是互联网的时代,传统的线下业务已经满足不了企业…

日期:2020-03-06 浏览次数:235

房地产税还有2年到达战场,3千多南京人涌向了河西...

关注两会3月4日的人大新闻发布会上,针对房地产税,发言人张业…

日期:2020-03-06 浏览次数:133

南京仙林汽配城内一物流公司卷款跑路

3月5日,有市民反映,南京仙林汽配城内的一家物流公司突然跑路…

日期:2020-03-06 浏览次数:106

关于我们
技术支持
联系我们
南京典乐科技
客服电话:400-025-1949 (工作日9:00~18:00)
项目经理:138-519-41123
咨询 Q Q:260193150
公司地址:南京中华路420号江苏省科技中心5层
客服QQ
获取报价
联系电话
400-025-1949
返回顶部