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

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

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

    今天写代码的时候创建了一个方法 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   2019-11-11 16:56:13 +08:00
    @KentY 大佬受教,写注释就是这个目的
    zsc8917zsc
        12
    zsc8917zsc   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   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   ·   我们的愿景   ·   广告投放   ·   感谢   ·   实用小工具   ·   3397 人在线   最高记录 5497   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 31ms · UTC 05:34 · PVG 13:34 · LAX 21:34 · JFK 00:34
    ♥ Do have faith in what you're doing.