Project1

标题: 有没有必要给代码写注释呢 [打印本页]

作者: M.Winderic. 时间: 2014-7-24 12:25
标题: 有没有必要给代码写注释呢
本帖最后由 M.Winderic. 于 2014-7-24 12:22 编辑

Discuz X2的新人贴标签实在是无力吐槽，只好先水一贴了...
格式化代码什么的最头疼了. 基本相当于把代码重写一遍... (大雾

作者: 上贺茂润 时间: 2014-7-24 12:40
不但不注释，删注释还是我的喜好之一

作者: kuerlulu 时间: 2014-7-24 12:49
# 你存在
# 我深深地脑海里
# 怎么爱你都不嫌多
~~↑ 直接发这个是纯水吧~~
# 如果你能看懂这段代码请给我发邮件 [email protected] 因为我也看不懂
def papapa(*)
=begin~!!@#$%^&*(
=end
return
end

作者: taroxd 时间: 2014-7-24 12:57
就算不考虑自己看不懂的情况，注释也可以使代码更加美观，并且更容易根据功能搜索到方法。

作者: zeldafd 时间: 2014-7-24 13:27
只要寫之前有好好思考方法和設計模式, 沒注解其實完全沒有問題

作者: 化螺耕 时间: 2014-7-24 13:37
看脚本的时候有注释当然更好理解

作者: 克莉丝 时间: 2014-7-24 14:50
在你将它做成一个精密的盒子之前你不可以抛弃注释

作者: 鑫晴 时间: 2014-7-24 14:51
第一天：切这行代码我倒背如流这么简单的逻辑思维猪都能看懂
第二天：嗯...这里首先是这样...然后是这样..然后是那样...噢耶，想起来了！
...
N天后：天啊，这段东西是什么玩意？？谁写的啊？噢我的妈呀，看得懂的一点都是天才

作者: 冰水金刚 时间: 2014-7-24 15:11
我的注释都是写在脚本最上面（单独成立，和我写的脚本是分开的。。。）
他只有框架的作用

作者: taroxd 时间: 2014-7-24 15:14

冰水金刚发表于 2014-7-24 15:11
我的注释都是写在脚本最上面（单独成立，和我写的脚本是分开的。。。）
他只有框架的作用 ...

可是我没有看到你发过脚本啊= =

作者: IamI 时间: 2014-7-24 15:28
好代码是Self-Documented的。
对于距离写完它不超过2个小时的那个作者来说。

作者: 喵呜喵5 时间: 2014-7-24 15:58
与其了增加日后的维护成本，我还是愿意选择写上注释

不写注释的代码不是逻辑很简单就是我自己根本不用

我会说我连事件页里都会写上注释么

作者: 双黄连2_副本2 时间: 2014-7-24 16:03
要看你写什么脚本咯，如果是要经常改动就写注释，如果简明易懂就不用写，不过注释其实可以用作美观，比如一段代码分几部份的，如果全部都黏在一起看起来就密密麻麻，如果在必要的地方加一些显眼的注释想必可以让你更快找到你需要找的东西。

作者: taroxd 时间: 2014-7-24 16:07
本帖最后由 taroxd 于 2014-7-24 16:11 编辑

双黄连2_副本2 发表于 2014-7-24 16:03
要看你写什么脚本咯，如果是要经常改动就写注释，如果简明易懂就不用写，不过注释其实可以用作美观，比如一 ...

每一小段代码（比如一个方法）都简明易懂，连在一起或者过个几天就不简明易懂了呢~

虽然说，即使不加注释，我大概还会根据方法名记得我这个方法干了什么。
但是找起来就会很累。

而且RGSS风格的注释本来就有利于代码的美观嘛（强迫症去死

不过呢，在提问区回答问题随手写的脚本，除了使用方法之外我从不写注释就是了kira☆~

作者: 118218157 时间: 2014-7-24 17:01
逻辑复杂的地方加注释

作者: 叶城 时间: 2014-7-24 17:49
加注释还是很有必要的，比如说可以让代码阅读，维护，查找更方便。
而且码代码疲劳时也可是通过加一些吐槽性质的注释来娱乐一下。
当然了，老加注释会有一些后遗症的，比如说吧自己的心里话加成注释。。。。。//今天竟然没加班！老板今天绝对没吃药！

作者: hys111111 时间: 2014-7-24 19:13
如果不令自己看得很晕，一般都不去注释。

作者: zl52wcl66rpg001 时间: 2014-7-24 21:15
作者自己看对外保密的写不写都行，希望共同分享共同研讨的最好是写上！反正想做好东西的都会写上，方便查找，挖坑埋自己的无所谓！

作者: orochi2k 时间: 2014-7-25 03:07
石器10年前的代码偶现在还能读懂，算神马水平（大雾）

作者: 无脑之人 时间: 2014-7-25 11:50
必要的注释还是保留吧……
咱一般不怎么写注释，但是碰到模板元编程那种一眼看不出来的什么的就会留个注释放在那里防止以后看不懂了
Ruby的话一般是没写完的地方或者需要明确指出是什么东西（我真心不打算从ruby代码里面看出写了些啥）的地方填上注释

没注释的结果比较伤感，咱之前的麻将姬里面的和牌搜索算法我已经找不到了，咱的STG生成敌人和弹幕的参数格式也找不到了，然后那两个坑就理所当然的坑掉了

欢迎光临 Project1 (https://rpg.blue/)