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

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

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

https://www.v2ex.com/t/16588

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

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

© 2021 V2EX