V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
zsc8917zsc
V2EX  ›  程序员

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

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

    今天写代码的时候创建了一个方法 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 大佬受教,写注释就是这个目的
    zsc8917zsc
        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   ·   我们的愿景   ·   实用小工具   ·   3254 人在线   最高记录 6543   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 26ms · UTC 11:46 · PVG 19:46 · LAX 04:46 · JFK 07:46
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.