注释写得太多了会挨打吗？

[fundebug]

[ben1024]

不推荐写注释，写注释是因为看代码不知道在做什么

[zsy979]

如果注释跟代码是一致的请他吃饭啊

[Linxing]

你敢不写试试？

[Edwards]

接受代码写得不好，但是不接受文档写的不好的，同理注释。

[NicholasYX]

一打眼就能看明白的没有必要写注释吧……

[xpresslink]

@fundebug
python 有一个专门生成文档的工具叫 sphinx，自己从代码中抽取注释生成结构化的 HTML 文档。
flask 的文档就是这么生成的。
好处是文档和代码是在一起的便于维护更新，每个人在代码里写自己的文档就好了。
最后只要生成一下就是最新的文档了，不用费力有专人去维护文档的一致性。

[q397064399]

@fundebug #80 Python 没有注释 就没法合作了，这种动态语言 是真的令人难受

[brondogk886]

这么全面的注释，不维护的话估计会被人打死

[xxl11231220]

求之不得。表示嫌弃不写少些注释的

[FifiLyu]

代码应该做到自解释，你这样如果精力不够时，很容易出现注释和代码不同步，最终更加误导人。

[junbaor]

看起来这是个稍微底层的方法，这注释写的，完美~

[northernlights]

@looseChen 我可没这本事，看来你经验丰富，你自己去吃吧。

[tiedan]

待过一家公司都不让写注释

[noNOno]

还是蛮好的

[ioth]

我会比较尊重这样的孩子。

[Mavious]

作为新手，最喜欢注释多多的代码了，每一行的功能都能靠注释看懂。
多多益善。

[ljspython]

注释永远不嫌多

[nomemo]

挺不错的，就是要持续维护

[AllenW]

这注释 厉害了

[sorra]

写错了才挨打