黑马程序员技术交流社区

标题: 写注释的时间比写码时间长，怎么破？ [打印本页]

作者: 编号3363 时间: 2016-3-26 01:41
标题: 写注释的时间比写码时间长，怎么破？
之前在知乎上看到关于程序员码德的问题，其中一条回答是“印度程序员代码才写几行，注释要写三百行”。个人理解的意思是如果有必要，写代码注释要足够清晰，尽量要让别人也看得懂。
最近试了下，完了发现写注释的时间貌似比敲码的时间长（除去敲码前分析需求所花的时间）。
各位大神对此怎么看？
有没有什么好的改进方法？

作者: 堕落天使 时间: 2016-3-26 08:14
写注释有利于思路的分析，也统一保证代码的逻辑正确性，但是不用太刻意的去关注注释，要是为了写注释而去写注释，就会在注释上花过多的时间而得不偿失。

作者: ySssssssss 时间: 2016-3-26 20:47
新手过来学习一下

作者: 爱尘iPhone 时间: 2016-3-26 22:07
写注释是一个逻辑框架的过程正确的逻辑反而能提高代码的速度所以并不是写注释与写代码时间的比较

作者: a752538236 时间: 2016-3-26 22:11
不是有那个vvdocumenter插件么，有快捷格式的话注释写的简练些，应该费不了多少时间

作者: 编号3363 时间: 2016-3-27 00:43

堕落天使发表于 2016-3-26 08:14
写注释有利于思路的分析，也统一保证代码的逻辑正确性，但是不用太刻意的去关注注释，要是为了写注释而去写 ...

嗯。。。。。有道理。

作者: 编号3363 时间: 2016-3-27 00:47

a752538236 发表于 2016-3-26 22:11
不是有那个vvdocumenter插件么，有快捷格式的话注释写的简练些，应该费不了多少时间 ...

嗯。。。。。。。。回头去下一个

作者: muzipiao 时间: 2016-3-27 00:49
印度程序员代码才写几行，注释要写三百行！！！太夸张了吧，这样的代码特别难懂复杂么，自带论文

作者: Zhangqi27 时间: 2016-3-27 22:44
你要知道当你越来越厉害你所写的注释也是给跟你一样厉害的人看的，
简单术语就可以表示了
比如
赋值，遍历

作者: 枼子 时间: 2016-3-27 22:58
注释越精简越好，简单易懂的代码就不需要注释了，每声明一个变量就需要注释一下，逻辑思维复杂的代码也需要说明为什么，

作者: 编号3363 时间: 2016-3-29 21:36

muzipiao 发表于 2016-3-27 00:49
印度程序员代码才写几行，注释要写三百行！！！太夸张了吧，这样的代码特别难懂复杂么，自带论文 ...

这是夸张的形容，大概意思是对方注释写得详细。

作者: 编号3363 时间: 2016-3-29 21:39

Zhangqi27 发表于 2016-3-27 22:44
你要知道当你越来越厉害你所写的注释也是给跟你一样厉害的人看的，
简单术语就可以表示了
比如

嗯，昨天跟讲师聊到这个问题，他说的是代码写得越简洁，越容易看懂。

作者: 编号3363 时间: 2016-3-29 21:42

枼子发表于 2016-3-27 22:58
注释越精简越好，简单易懂的代码就不需要注释了，每声明一个变量就需要注释一下，逻辑思维复杂的代码也需要 ...

嗯，变量是需要注释。

作者: tdwydan1 时间: 2016-3-29 22:14
我写注释都是把程序写完才去写的，主要是为了方便自己在理解一遍，还有就是让别人也能看得懂，不过写代码前写注释的习惯没养成，上来就手痒开始敲了，这样的习惯不好，很容易在一个点上卡住。

作者: 编号3363 时间: 2016-3-30 00:05

tdwydan1 发表于 2016-3-29 22:14
我写注释都是把程序写完才去写的，主要是为了方便自己在理解一遍，还有就是让别人也能看得懂，不过写代码前 ...

哈哈！“手痒”+1！
之前我也是这样，甚至连思路都没想，上机就是就噼里啪啦一顿敲。

作者: 大彬周 时间: 2016-3-30 01:04
加油加油~~

欢迎光临黑马程序员技术交流社区 (http://bbs.itheima.com/)

黑马程序员IT技术论坛 X3.2