楼主:
chia7712 (Spright)
2018-01-28 03:10:56※ 引述《Ommm5566 (56天团)》之铭言：
: ※ 引述《p52189 (鼠霸)》之铭言：
: : 如题……原始码不长
: : 但撰码习惯跟我完全不同
: : 到现在我也还没找到规则
: : 以至于想改一小部分都因为不知道规则而必须几乎全部爬一遍才改得动
: : 每次读都很难沉住气一下就很烦躁不想做了
: : 一直这样很像也不是办法
: : 请问大家有什么方法可以坐得住吗= =
: : 谢谢……
: :
除非很明显在做啥 我们几乎所有的 code都要注解
我遇到的快要被要求接近每一行都要我刚加入时就是在帮别人写注解 Q_Q
每一行都要注解也太拢长了，要不要看看写法是否可以调整？
作者:
robler (章鱼丸)
2018-01-28 10:09:00注解写太多只是突显程式写的很烂的问题
作者:
NDark (溺于黑暗)
2018-01-28 10:16:00光写不写注解就吵成一片了. 还谈什么风格.---- 以下 tab/space大战 开始 ----
我也当初这样反映过 不过要照什么convention...也是只有那种很明显的code才不用写
读人家代码需要什么休养? 就能力不够读的很痛苦而已代码到底有多难读，就跟文章一样你是语言不熟吗?不要自己烂就觉得读的痛苦很正常好吗看一下架构就知道他等级到哪了，根本没难度好吗不会写的也不可能分层到哪里去也不太需要切到几次class可悲
作者:
feeya (24 August 升格为乡民)
2018-01-28 11:32:00一个func有3~4页常都是if包if包好几层 这种读的很痛苦
某T干嘛7pupu,又不是什么状况你都遇过,还是你写的code,别人觉得难读?
老子看别人code好多年，也帮别人改过 根本没感觉就读起来很不方便而已 没必要讲的好像看别人CODE很生气代表自己很强，我最讨厌这种装b的
作者:
stosto (树多)
2018-01-28 12:37:00看得不爽骂两句而已,这种东西读不懂该检讨自己吧
T大是真的没看过程式码写的很烂的，所谓很烂指的是该缩排不缩；好几层if；程式码太多重复；变量随便乱取乱创看不懂是真的，因为call来call去，自己也不知道call哪
作者:
Masakiad (Masaki)
2018-01-28 12:58:00高阶语言需要注解都是本身写太烂
作者:
sharku (明珠求瑕)
2018-01-28 13:45:00推楼上
作者:
tyc5116 (累人啊....)
2018-01-28 15:46:00T大试着去读看看泡泡code吧，看你要花多少时间
我看过用AJAX call来call去的 追得很不爽
作者:
Ommm5566 (56天團)
2018-01-28 18:19:00泡泡code好怀念 IOCCC大赛
作者:
y3k (激流を制するは静水)
2018-01-28 18:31:00高阶语言需要注解都不及格+1
你也知道立场不同差很多了，搞不好下一个看到你的code又觉得这个人写注解也写的太囉嗦了，又上来PO文lol我也很讨厌那种整天嫌人写code怎样的，感觉很幼稚
作者:
mathrew (Joey)
2018-01-28 20:24:00每行都写反而更难读吧 一团乱
作者:
Ommm5566 (56天團)
2018-01-28 20:32:00现在越来越强调Hierarchy的设计了 毕竟大团队是小团队组成 拆成小团队就还可以最表面给user使用的API接口型状和抽象层次要同一注解也尽量详尽 这个层级的注解相当于文件了然后中间各个team自行决定coding style 注解适量最下层每个人会有各自的习惯 这边就仰赖写程度和良心不管什么时候遇到个人习惯都是无解阿XD
楼主:
chia7712 (Spright)
2018-01-28 22:08:00别激动啊。读code的耐心不一定是指对方code不好，很多时候只是写code的人的逻辑差异甚大而已，而这也是为啥注解很重要。能不用注解就让团队都看懂的程式码很棒，但事实上专案不大还可以达到，但当你专案长到几百万行的时候就有难度了
作者:
NDark (溺于黑暗)
2018-01-28 22:48:00楼上有逻辑漏洞. 一开始都不会认为最后会变成几百万行.
我也觉得每行都写一团乱 但就如楼上几楼所说的要看是前还是后 有些API真的就是要求一行一行写好处就是后面的人可以跟上不过最烦的还是不写英文的...写什么法语之类的Q_Q
靠杯我看过写日文的注解跟德文的XDD变量名称与其物理意义不相符也很囧
作者:
chuegou (chuegou)
2018-01-28 23:53:00我现在遇到最困扰是magic number没注解 只能干瞪眼
作者:
netburst (133 134 592)
2018-01-29 00:15:00缩排没差吧 IDE FORMAT一秒
事实上就是没有完美的 coding style 什么高阶语言不用注解在大一点的codebase 是不大可能的人人都觉得自己写得最漂亮
楼主:
chia7712 (Spright)
2018-01-29 02:15:00NDark大说到重点了，一开始没把专案当成大型专案来管理，等到有一天发现已经变成怪物就来不及了，只能付出更多时间来补救。
我主管都只想解决眼前问题 没想到日后维护制造出来的技术债只好后人来还了
对于注解的想法,我的观念是站在clean code这边,也就是非必要不写注解
作者:
SABA0 (A柱)
2018-01-29 16:49:00没看过用注解写日记的吼。 看得我都要哭了
哈哈哈非必要不写 所以你的命名都很完美?语意真的都清楚可以让后人看懂?
常常实作还会有一些假设 复杂度也未知 没写注释就是要读内容搂
我是看过很多人只会逼别人写注解,然后自己死不肯写注解说自己写的code好所以不写,然后又爱批评别人的注解
Sidney0503你在悲愤啥?看清楚我表达的是非必要不写,不是绝对不写,你觉得取名技巧不好人家看不懂,不就是你说我说的"必要的时候"吗?
作者:
Ghamu (猫丸)
2018-01-31 01:06:00我都是func名称无法表达意思 想一阵 真不得已才上注解补充所以对那种胡乱取名 写一大堆注解的人超不爽想骂干 代表根本就没把其他合作开发的工程师放在眼里嘛clean code也说过了 注解一堆根本不可能期待会被下一个改的人持续更新维护 有一个人漏 下次看到注解与程式本身不一致就会陷入混乱
作者: t64141 (榕树) 2018-01-31 10:24:00
同意楼上，年久失修的注解常常扮演误导后人的角色