590
社区成员
发帖
与我相关
我的任务
分享领导说：写代码不允许写注释
小生是刚出学门，因为没有去过别的IT公司，这是职业生涯中的第一个IT公司，刚来的时候感觉什么都很新鲜。
记得在学校的时候，老师教育我们，写代码一定要写好注释，并且很多时候都强调我们注释的重要性，和不建议使用goto语句那个道理一样，铭记在心中。
到公司以后，终于看到了实战中的项目是个什么样子，领导让我svn了代码，都是C代码，整个工程的代码非常多，奇怪的是，没有一行注释代码，也没有什么doc的所谓的API注释，傻眼了，试着问了几次人家，后来人家烦了，说“你自己去研究嘛，不会想办法嘛，工作总是要做的嘛，要是什么都问我的话，我还要你干嘛？”这是人家的原话，我无奈了。
有一次，我看懂了一点，就自己标记了点注释给自己看，谁知道让人家看到了，人家说不要写注释，人家说注释其实没有什么用的，后面还加上“真的不骗你”。
我不知直接领导是出于什么目的，也许是他不愿让别人搞懂他这个东西，也许是别的。开始的时候他给我说这个库是他自己写的，后来我知道了，他也是刚出大学校门没有几年的时间，不超过5年，而这个库已经用了不下十年之久了。
公司用的是一个图形库，后来我仔细看了底层的代码以后，从半点注释痕迹发现这个库十几年前就有了，奇怪的是，在互联网发达的今天，网上竟然没有一句半行的代码，我就想，如果这是中国人写的东西，那中国人的保密工作做的也太好了吧，如果是外国人写的，那怎么流传到这里的呢，我纳闷了，到国内国外的网站上，找了好久，没有半点蛛丝马迹。
没有什么参考的东西，没有注释，还不能写注释，还要完成工作，用人家给的库。
我怎么就遇到这样的领导，你们呢?
记得在学校的时候，老师教育我们，写代码一定要写好注释，并且很多时候都强调我们注释的重要性，和不建议使用goto语句那个道理一样，铭记在心中。
到公司以后，终于看到了实战中的项目是个什么样子，领导让我svn了代码，都是C代码，整个工程的代码非常多，奇怪的是，没有一行注释代码，也没有什么doc的所谓的API注释，傻眼了，试着问了几次人家，后来人家烦了，说“你自己去研究嘛，不会想办法嘛，工作总是要做的嘛，要是什么都问我的话，我还要你干嘛？”这是人家的原话，我无奈了。
有一次，我看懂了一点，就自己标记了点注释给自己看，谁知道让人家看到了，人家说不要写注释，人家说注释其实没有什么用的，后面还加上“真的不骗你”。
我不知直接领导是出于什么目的，也许是他不愿让别人搞懂他这个东西，也许是别的。开始的时候他给我说这个库是他自己写的，后来我知道了，他也是刚出大学校门没有几年的时间，不超过5年，而这个库已经用了不下十年之久了。
公司用的是一个图形库，后来我仔细看了底层的代码以后，从半点注释痕迹发现这个库十几年前就有了，奇怪的是，在互联网发达的今天，网上竟然没有一句半行的代码，我就想，如果这是中国人写的东西，那中国人的保密工作做的也太好了吧，如果是外国人写的，那怎么流传到这里的呢，我纳闷了，到国内国外的网站上，找了好久，没有半点蛛丝马迹。
没有什么参考的东西，没有注释，还不能写注释，还要完成工作，用人家给的库。
我怎么就遇到这样的领导，你们呢?
...全文
请发表友善的回复…
发表回复
t1397018 2012-12-30
- 打赏
- 举报
好代码是自注释的，工作中常会发现为了注释而注释，一些人从别的比方拷注视过来改，漏了一两个地方往往会给人造成更大的误解。所以我认为只有确实需要注释的地方才去注释，否则还是尽量保持干净
hackervip1988 2012-12-29
- 打赏
- 举报
都一样 ， 我们公司 也是这幅德行。。。。
一个页面多达 5-6K 行代码 基本没注释
问别人：别人说自己看
没得办法 ， 生活是自己的 ，还得硬着头皮上
出来混，不要担心被打击
sz_guduzhe 2012-12-28
- 打赏
- 举报
脑残领导。。。。
sanyuelideyu6666 2012-12-17
- 打赏
- 举报
将帅无能累死三军
devgis 2012-12-17
- 打赏
- 举报
很明显的保密性要求 这样的代码即使泄露了也影响不是很大的！
西門十方 2012-12-16
- 打赏
- 举报
有多出來的時間寫注释,還不如把原碼改的更簡單易懂,以後要reuse也好用
用寫人看不懂的 code 來保密早就是過時的方式,用Algorithm用knowho來卡,才是王道
转角天边 2012-12-09
- 打赏
- 举报
疯狂的红豆 2012-12-08
- 打赏
- 举报
上个学期写的代码，虽然不是什么了不起的，但是没有注释的地方已经不知道是干嘛的了，通读代码才知道是干嘛的。
wangzhezhifeng007 2012-10-28
- 打赏
- 举报
现在的我还在公司加班呢，让一个女生情何以堪
我要火力全开 2012-10-27
- 打赏
- 举报
我觉得领导肯定有某种不想让人知道的心理
akcw007 2012-10-25
- 打赏
- 举报
函数名字，变量名，参数名，就是最好的注释
lsbggg 2012-10-25
- 打赏
- 举报
提交代码不写注释的人，小鸡鸡就跟注释一样长。
名叫比尔盖子 2012-10-25
- 打赏
- 举报
，阅过
cntigercat 2012-10-24
- 打赏
- 举报
出于保密吧。。。
magicyang87 2012-10-24
- 打赏
- 举报
强制注释和强制不注释都不可取，特别对于新手想达到“代码是最好的注释”根本无从谈起
code2005_2012 2012-10-24
- 打赏
- 举报
我写代码追求简单明了，几乎也不写注释，看代码就知道是什么意思了。
l4kangaxx 2012-10-24
- 打赏
- 举报
领导的话不完全错吧，注释写的不好，看注释比看代码还累，另外补填注释的确比没有注释更糟，想LZ你确定你的注释比代码本事更加准确，清晰么？
总是想得太多 2012-10-24
- 打赏
- 举报
[Quote=引用 5 楼 的回复:]
你遇到极品了，不过也就凑活着过吧，过那么几年，技术也就那么回事
[/Quote]
貌似现在极品很多哦..
你遇到极品了，不过也就凑活着过吧，过那么几年，技术也就那么回事
[/Quote]
貌似现在极品很多哦..
总是想得太多 2012-10-24
- 打赏
- 举报
现在好多做技术的都是这个样子，一副很经验丰富的样子，可是什么文档笔记都没有，你问又不会跟你说，说什么我都整理好了要你干嘛。
这可能是很多IT公司的通病吧，人家都说教会徒弟饿死师傅，中国传统嘛。
所以，问自己的问题，生他的气去吧，自己学到了是自己的，可一定不能学他，做好自己的笔记、做好技术总结，相信将来你不会比他差
这可能是很多IT公司的通病吧，人家都说教会徒弟饿死师傅，中国传统嘛。
所以，问自己的问题，生他的气去吧，自己学到了是自己的，可一定不能学他，做好自己的笔记、做好技术总结，相信将来你不会比他差
钱币老顽童 2012-10-24
- 打赏
- 举报
你们领导就是个瓜怂，哪有开发项目不写注释的，就连微软也都有注释啊。
加载更多回复（142）
