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

V2EX = way to explore

V2EX 是一个关于分享和探索的地方

现在注册

已注册用户请登录

• 请不要在回答技术问题时复制粘贴 AI 生成的内容

这是一个创建于 1874 天前的主题，其中的信息可能已经有所发展或是发生改变。

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

注释

代码

顺手

parameters

17 条回复 • 2019-11-11 18:20:48 +08:00

optional

2019-11-11 16:23:09 +08:00

getLastTaskByTopicId 这样的命名不需要注释

ydatong

2019-11-11 16:24:45 +08:00 via iPhone

有点像 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 via Android

@kokodayo 说不定会写但是英文不好

justfly

2019-11-11 18:20:48 +08:00

这 lastest。。。还是写中文吧