命名规范与注释哪个更重要?

2011 年 8 月 7 日
 wtl
吐槽一下 窃以注释没空可以不写 命名一定要规范
不少人写的代码很让人受不了 随意简写变量名及方法名
看代码非要时不时去看注释 又恶心又累
多打两个字 名字本身即是注释
何必呢?
6248 次点击
所在节点    随想
12 条回复
dongsheng
2011 年 8 月 7 日
命名是件纠结的事,好的命名是高质量代码的重要部分
fluke
2011 年 8 月 7 日
两个都重要,好的命名可以节省注释。
Harry
2011 年 8 月 7 日
更重要的是命名。一个好的命名本身就是注释,而且是好的注释。
zythum
2011 年 8 月 7 日
只要能让下个人可以方便得看懂就好。
glume
2011 年 8 月 23 日
两手抓,两手都要硬。
pinepara
2011 年 8 月 23 日
好的代码应该是自注释的。
不涉及到复杂算法的地方应该让代码不依赖注释也完全可读。
wtl
2011 年 8 月 23 日
@pinepara 深以为然!
tox
2011 年 8 月 23 日
一直注意命名问题,现在注释很少写,以后要改。
项目紧的话,有时命名也很坑。
orzzzzz
2011 年 8 月 23 日
两码事,都很重要...不能相互替代,只能说相互增益.
命名可以说明的注释就不是需要的注释....但并不是说,只要有好的命名了,就不需要注释了.
--
回头补注释的机会很微....当然,你会想,重构的时候再....咳咳...
dogFish
2011 年 8 月 23 日
webkit的代码里就很少有注释, 因为变量函数命名清晰易懂
myrual
2011 年 8 月 23 日
能够自解释的代码会好很多。
但是自解释的效果和文字表达能力有关。
同时自解释的效果也和程序工作原理有关,如果基于某个复杂的数据结构或者算法,自解释也没意义。
如果代码设计是按着业务流程的来设计的话,那么维护的难度会简单很多。
如果是按着内部如何实现的方法来设计的话,那么维护的难度会大一点,毕竟维护者要理解技术上是怎么实现的,并且理解业务和技术实现如何连接的
obiwong
2011 年 8 月 28 日
减法和加法哪个更重要?

这是一个专为移动设备优化的页面(即为了让你能够在 Google 搜索结果里秒开这个页面),如果你希望参与 V2EX 社区的讨论,你可以继续到 V2EX 上打开本讨论主题的完整版本。

https://study.congcong.us/t/16588

V2EX 是创意工作者们的社区,是一个分享自己正在做的有趣事物、交流想法,可以遇见新朋友甚至新机会的地方。

V2EX is a community of developers, designers and creative people.

© 2021 V2EX