今天写代码的时候顺手写了一段英文注释...写完以后一阵迷茫... - V2EX
V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
请不要在回答技术问题时复制粘贴 AI 生成的内容
zsc8917zsc
V2EX    程序员

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

  •  
  •   zsc8917zsc 2019-11-11 16:18:15 +08:00 4312 次点击
    这是一个创建于 2239 天前的主题,其中的信息可能已经有所发展或是发生改变。

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

    17 条回复    2019-11-11 18:20:48 +08:00
    optional
        1
    optional  
       2019-11-11 16:23:09 +08:00
    getLastTaskByTopicId 这样的命名不需要注释
    ydatong
        2
    ydatong  
       2019-11-11 16:24:45 +08:00 via iPhone
    有点像 iOS 开发,以前写 oc 写习惯了,现在我写什么代码方法名都好长
    dppd
        3
    dppd  
       2019-11-11 16:24:46 +08:00
    命名已经很清晰了?
    memedahui
        4
    memedahui  
       2019-11-11 16:26:29 +08:00
    我一般就是 function1,function1-1,function3-4,这个样子!
    yaoye555
        5
    yaoye555  
       2019-11-11 16:30:22 +08:00
    我一般就 f1 f2 f3
    Chieh
        6
    Chieh  
       2019-11-11 16:30:41 +08:00
    @optional 遇到看不懂英文的领导他会要求你照样写上中文注释
    metrxqin
        7
    metrxqin  
       2019-11-11 16:35:08 +08:00   1
    方法名是 LastTask,注释是 Lastest Task,究竟是什么 Task ??? 另外 Lastest 不是一个单词。
    ishiguang
        8
    ishiguang  
       2019-11-11 16:43:28 +08:00
    是不是应该改成....额....不会...
    KentY
        9
    KentY  
       2019-11-11 16:47:58 +08:00   3
    comment 应该 tells "why" instead of "what".
    Cukuyo
        10
    Cukuyo  
       2019-11-11 16:48:04 +08:00
    不要嫌弃方法名太长
    zsc8917zsc
        11
    zsc8917zsc  
    OP
       2019-11-11 16:56:13 +08:00
    @KentY 大佬受教,写注释就是这个目的
    zsc8917zc
        12
    zsc8917zsc  
    OP
       2019-11-11 16:57:36 +08:00
    @Cukuyo 让我想起了公会名字长一点可以趁联盟看公会名字时多打他两下系列....
    csusong
        13
    csusong  
       2019-11-11 17:29:37 +08:00
    调用过我司大佬写的服务,方法名得有 60 多个字母 /:dog
    zsc8917zsc
        14
    zsc8917zsc  
    OP
       2019-11-11 17:32:21 +08:00
    @csusong 容我在心里膜拜一下大佬
    kokodayo
        15
    kokodayo  
       2019-11-11 17:59:15 +08:00
    @Chieh 遇到看不懂英文还非要看代码的领导不是应该当场辞职?
    u823tg
        16
    u823tg  
       2019-11-11 18:19:35 +08:00 via Android
    @kokodayo 说不定会写但是英文不好
    justfly
        17
    justfly  
       2019-11-11 18:20:48 +08:00
    这 lastest。。。 还是写中文吧
    关于     帮助文档     自助推广系统     博客     API     FAQ     Solana     2697 人在线   最高记录 6679       Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 25ms UTC 00:33 PVG 08:33 LAX 16:33 JFK 19:33
    Do have faith in what you're doing.
    ubao msn snddm index pchome yahoo rakuten mypaper meadowduck bidyahoo youbao zxmzxm asda bnvcg cvbfg dfscv mmhjk xxddc yybgb zznbn ccubao uaitu acv GXCV ET GDG YH FG BCVB FJFH CBRE CBC GDG ET54 WRWR RWER WREW WRWER RWER SDG EW SF DSFSF fbbs ubao fhd dfg ewr dg df ewwr ewwr et ruyut utut dfg fgd gdfgt etg dfgt dfgd ert4 gd fgg wr 235 wer3 we vsdf sdf gdf ert xcv sdf rwer hfd dfg cvb rwf afb dfh jgh bmn lgh rty gfds cxv xcv xcs vdas fdf fgd cv sdf tert sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf shasha9178 shasha9178 shasha9178 shasha9178 shasha9178 liflif2 liflif2 liflif2 liflif2 liflif2 liblib3 liblib3 liblib3 liblib3 liblib3 zhazha444 zhazha444 zhazha444 zhazha444 zhazha444 dende5 dende denden denden2 denden21 fenfen9 fenf619 fen619 fenfe9 fe619 sdf sdf sdf sdf sdf zhazh90 zhazh0 zhaa50 zha90 zh590 zho zhoz zhozh zhozho zhozho2 lislis lls95 lili95 lils5 liss9 sdf0ty987 sdft876 sdft9876 sdf09876 sd0t9876 sdf0ty98 sdf0976 sdf0ty986 sdf0ty96 sdf0t76 sdf0876 df0ty98 sf0t876 sd0ty76 sdy76 sdf76 sdf0t76 sdf0ty9 sdf0ty98 sdf0ty987 sdf0ty98 sdf6676 sdf876 sd876 sd876 sdf6 sdf6 sdf9876 sdf0t sdf06 sdf0ty9776 sdf0ty9776 sdf0ty76 sdf8876 sdf0t sd6 sdf06 s688876 sd688 sdf86