关于阿里代码规约的不能使用行位注释的疑问

2019-05-29 11:44:28 +08:00
 weo0

个人感觉行位注释完全没啥问题，为啥规约要求不能行位注释，求大佬解释一下。

4407 次点击
所在节点    问与答
11 条回复
CSGO
2019-05-29 12:03:37 +08:00
󠀡
smeraldo
2019-05-29 12:45:07 +08:00
然而我没看到规约里有这么说过啊
gogotanc
2019-05-29 13:55:24 +08:00
是行尾吧，
Aresxue
2019-05-29 14:08:52 +08:00
可以行位注释，但是成员变量建议用文本注释，因为文本注释是可以被 javadoc 提取出来的，在生成的文档中会有体现，而行位的就没了。
mapper
2019-05-29 14:21:52 +08:00
行尾吧？ 主要是为了规范，不然一会行级注释，一会行尾注释多了之后就很乱 。
weo0
2019-05-29 14:48:30 +08:00
@mapper 是行尾，手残打错了
Raisu
2019-05-29 15:00:55 +08:00
我也不推荐
nekoneko
2019-05-29 15:11:30 +08:00
个人习惯不喜欢行尾注释。注释和代码放一行我会下意识看代码，然后就不看注释了
uxstone
2019-05-29 15:28:04 +08:00
那么问题来了 注释写代码上面还是代码下面？
weo0
2019-05-29 15:29:47 +08:00
@uxstone 我感觉应该不写，哈哈哈哈
weo0
2019-05-29 15:30:16 +08:00
@CSGO 卧槽，这才看到，居然同款头像

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

https://tanronggui.xyz/t/568689

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

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

© 2021 V2EX