团队开发代码不爱写注释，如何解决这一困境？

[labulaka521]

刚入职不久，维护的心累，在别人的没有注释代码上加功能是真的难受

怎么让大家对于比较复杂的逻辑习惯写上注释

[sdushn]

做 cr 啊，看不懂的，格式不对的都不让合入，

[djyde]

注释不是用来解释这段代码在做什么，而是告诉后来的人为什么要写这段代码。

[paoqi2048]

楼上一堆洗的，希望你们以后的同事都不写注释哈

[haha512]

看了上面回答，应该把第一个设计代码要加注释的人拉出来痛打一顿。
v2 任何一个问题下面， 总少不了一堆的“逼王之王”，为什么呢

[pangleon]

让 AB 互相改他们之前做的大需求，然后看他们对喷

[labulaka521]

@haha512 没办法 总有人觉得我的代码很优雅 很优雅 不用注释 结果一看 是什么玩意 叠加五六层 ifelse 真逼王之王

[lululau]

业务代码不需要注释，类名和方法名就是注释，把 PRD 写写好是最重要的

[opengps]

写注释奖钱啊，很多人不写，不就是因为大部分企业都卸磨杀驴吗

[wysnylc]

@labulaka521 #86 你要保持这个心态,永远不要觉得自己优雅
优雅是别人对你的评价,不是自己觉得自己多牛逼,总有些人觉得自己写点代码就人上人了莫名其妙的优越感
不写注释的都是垃圾

[Leigg]

楼上一帮人，个个以为光看代码就看懂了，要么是真牛逼，没遇到过垃圾同事，要么是长期混迹小公司自己就从来不写注释的，别人问还怼别人的。
哪个比例更高一点？

[Huelse]

当然是能一起商量好最好

实在不行就你写的时候完全不按套路命名来写即可，注释留在自己的仓库，commit 的时候去掉注释

[zerofancy]

lint

[tony1890]

没办法。只能管好自己。虽然我跟同事说过多次，不用的代码要么注释要么删除，方法最起码说明是干嘛的，公共方法还要写入参和 returns，公共组件要写文档。balabala 一堆。
然而他们很难做到。唯一欣慰的就是提交写简短记录了。

[newmlp]

又不是不能用

[darktutu]

@Still4 是啊，所以我挺好奇的，一般项目的注释都很完善，只有我遇到的是乱糟糟的?还有就是单元测试，也是没多少或者没有，到那时看评论，大家经常都是齐备的，我也搞不明白。

[tabris17]

我只在个人项目里会尽责地写注释

[troywinter]

题外话，注释和代码有不同的目的，不存在好的代码不需要写注释的，他们的目的本来就不相同，有些简单的逻辑确实不需要注释，但大多数情况下，注释还是应该解释下这样设计的原因和用法，最好链接到设计文档。

[qiumaoyuan]

@labulaka521 也许你见过你口里描述的人，但同时你要知道这世界上真有不少人的代码是不用注释的。把无法理解的事情打个装逼的标签，把难以实现的理想当作自己不努力的借口对自己没有好处。有理就好好讲理这是程序员的基本素养，起码冰冷的机器不会照顾你的个人情绪。

[tankren]

看可读性吧

[lazydog]

不写注释看来是真的不行，我一周前的代码，今天看的时候竟然看不懂了，费了好长时间才反推回去。