AI 写的代码自己都带注释,但我 review 时经常觉得它的注释是废话。是该保留、精简还是删掉重写?大家怎么处理?
登录后参与讨论
废话注释删掉,只留“为什么这么写”的,AI 这块写得最差。
注释应该解释意图,不是复述代码。AI 的注释大多属于后者,删一半起步。
我让 AI 在生成后单独补一句“这里为什么没采用更显然的写法”,出来的注释质量高很多。
关键业务逻辑的注释我会自己手写,确保准确。
删干净,好代码自解释,注释只在反直觉的地方加。
废话注释删掉,只留“为什么这么写”的,AI 这块写得最差。
注释应该解释意图,不是复述代码。AI 的注释大多属于后者,删一半起步。
我让 AI 在生成后单独补一句“这里为什么没采用更显然的写法”,出来的注释质量高很多。
关键业务逻辑的注释我会自己手写,确保准确。
删干净,好代码自解释,注释只在反直觉的地方加。