今天写代码的时候顺手写了一段英文注释...写完以后一阵迷茫...

2019-11-11 16:18:15 +08:00
 zsc8917zsc

今天写代码的时候创建了一个方法 getLastTaskByTopicId(id) 然后顺手写了一段英文注释 get specified parameters lastest task。。写完后发现我是谁...我在哪儿...我在干什么...默默的删掉注释换成了中文的....

3693 次点击
所在节点    程序员
17 条回复
optional
2019-11-11 16:23:09 +08:00
getLastTaskByTopicId 这样的命名不需要注释
ydatong
2019-11-11 16:24:45 +08:00
有点像 iOS 开发,以前写 oc 写习惯了,现在我写什么代码方法名都好长🤣
dppd
2019-11-11 16:24:46 +08:00
命名已经很清晰了?
memedahui
2019-11-11 16:26:29 +08:00
我一般就是 function1,function1-1,function3-4,这个样子!
yaoye555
2019-11-11 16:30:22 +08:00
我一般就 f1 f2 f3
Chieh
2019-11-11 16:30:41 +08:00
@optional 遇到看不懂英文的领导他会要求你照样写上中文注释
metrxqin
2019-11-11 16:35:08 +08:00
方法名是 LastTask,注释是 Lastest Task,究竟是什么 Task ??? 另外 Lastest 不是一个单词。
ishiguang
2019-11-11 16:43:28 +08:00
是不是应该改成....额....不会...
KentY
2019-11-11 16:47:58 +08:00
comment 应该 tells "why" instead of "what".
Cukuyo
2019-11-11 16:48:04 +08:00
不要嫌弃方法名太长
zsc8917zsc
2019-11-11 16:56:13 +08:00
@KentY 大佬受教,写注释就是这个目的
zsc8917zsc
2019-11-11 16:57:36 +08:00
@Cukuyo 让我想起了公会名字长一点可以趁联盟看公会名字时多打他两下系列....
csusong
2019-11-11 17:29:37 +08:00
调用过我司大佬写的服务,方法名得有 60 多个字母 /:dog
zsc8917zsc
2019-11-11 17:32:21 +08:00
@csusong 容我在心里膜拜一下大佬
kokodayo
2019-11-11 17:59:15 +08:00
@Chieh 遇到看不懂英文还非要看代码的领导不是应该当场辞职?
u823tg
2019-11-11 18:19:35 +08:00
@kokodayo 说不定会写但是英文不好
justfly
2019-11-11 18:20:48 +08:00
这 lastest。。。 还是写中文吧

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

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

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

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

© 2021 V2EX