感动, 这位粉丝给 gws 源码几乎每一行都写了注释 !

2024-08-05 09:53:02 +08:00
 Nazz

GWS 注解版 https://github.dev/shengyanli1982/gws/tree/dev

简介

GWS 是一个用 Go 编写的非常简单、快速、可靠且功能丰富的 WebSocket 实现, 它内置了压缩上下文接管, 代理, 广播 并发限制等等一系列实用功能, 您可以轻松编写自己的服务器或客户端。

14858 次点击
所在节点    Go 编程语言
94 条回复
lambdaq
2024-08-05 14:33:34 +08:00
AI 搞的?
sunzhenyucn
2024-08-05 14:40:49 +08:00
估计是 AI 生成用来混大量 PR 的 建议 revert 很多地方直接变量可以做到自注释,简单的逻辑也不需要太细致入微注释
lasuar
2024-08-05 14:48:32 +08:00
突然想到一句话,有些事情真不是勤奋就能做的好的,确实带点天赋。
Vtwoguest
2024-08-05 14:54:38 +08:00
代码简洁之道:无效注释不仅不能起到说明作用 反而会增加复杂度 注释要简短有力
tairan2006
2024-08-05 15:01:09 +08:00
大可不必都加上注释吧。

另外搞开源就别说粉丝了吧,感觉像是饭圈。。
jackmod
2024-08-05 15:06:43 +08:00
这注释是给人类看的? AIGC 污染环境。
反过来讲,都开始研究这种东西的源码了,会连 golang 的基础都看不懂吗?
dhb233
2024-08-05 15:10:35 +08:00
就是 AI 生成的注释,基本上按照变量名字猜,然后翻译出来。当做 AI 工具还有点用,提交到代码里完全没必要
iseki
2024-08-05 15:17:10 +08:00
除了降低代码可读性之外几乎没有任何价值
iseki
2024-08-05 15:18:25 +08:00
好的代码应尽量做到代码即注释,需要大量注释才能理解,只能证明代码难以清晰直观地表达意图,需要靠人类的自然语言辅助。
461229187
2024-08-05 15:18:30 +08:00
有没有像我一样的,用 copilot ,先写注释,自动生成代码,然后改改代码,然后继续这个循环
Wxh16144
2024-08-05 15:22:33 +08:00
(今天中午饭点在知乎看到类似讨论...
vfs
2024-08-05 15:23:52 +08:00
感觉作者有点儿疯了:)_
caocong
2024-08-05 15:30:21 +08:00
关于 ai 生成注释,反过来想是不是可以写代码时不用写注释了或者只在特殊逻辑的地方写,以后自己或他人再读代码时临时 ai 生成注释
0o0O0o0O0o
2024-08-05 15:32:28 +08:00

lisongeee
2024-08-05 15:51:41 +08:00
感觉是拿 gpt 批量生成的,好奇原作者会不会合并

反正如果是我,我首先评论一句感谢 pr ,然后发一句感觉没什么用就关闭 pr 了
barbery
2024-08-05 15:55:08 +08:00
@0o0O0o0O0o 刚好想到这图,哈哈哈哈
ychost
2024-08-05 16:15:11 +08:00
注释一般注释业务、产品背景
flyqie
2024-08-05 16:22:04 +08:00
这注释说真的。。感觉没啥用。

几乎每行都写注释我第一反应是恐怖,因为这种行为完全没有意义,而且居然还推给上游了。。

挺好奇楼主真的打算合并这个吗。

注释讲究的是适当,不适当的注释还不如没有,go 基础不好就回去专门学基础,没必要再项目中去搞这些。
zhaliao
2024-08-05 16:32:02 +08:00
评论区好多酸烂臭萝卜哦。跟蛆一样,于自己没有任何好处,还要恶心别人一把。
Nazz
2024-08-05 16:39:34 +08:00
@flyqie 要把多余的去掉,工作量蛮大

这是一个专为移动设备优化的页面(即为了让你能够在 Google 搜索结果里秒开这个页面),如果你希望参与 V2EX 社区的讨论,你可以继续到 V2EX 上打开本讨论主题的完整版本。

https://www.v2ex.com/t/1062520

V2EX 是创意工作者们的社区,是一个分享自己正在做的有趣事物、交流想法,可以遇见新朋友甚至新机会的地方。

V2EX is a community of developers, designers and creative people.

© 2021 V2EX