• 请不要在回答技术问题时复制粘贴 AI 生成的内容
1oNflow
V2EX  ›  程序员

什么样的代码是 maintainable 的?

  •  
  •   1oNflow · Mar 20, 2020 · 3109 views
    This topic created in 2278 days ago, the information mentioned may be changed or developed.

    需要遵循哪些语言无关的习惯和语言特定的规范?

    16 replies    2020-03-21 15:53:50 +08:00
    CEBBCAT
        1
    CEBBCAT  
       Mar 20, 2020 via Android
    (我个人觉得这个议题 too 大 to 讨论)
    Jirajine
        2
    Jirajine  
       Mar 20, 2020 via Android
    如何编写无法维护的代码
    https://coderlmn.github.io/frontEndCourse/unmaintainable.html

    当你知道什么样的代码是 unmaintainable,反过来就是 maintainable。
    nutting
        3
    nutting  
       Mar 20, 2020
    当然是变量,方法不要怕名字长,取得有含义,这样注释可以不用写太细,就把重要逻辑,特殊的地方写写了
    justfortest
        4
    justfortest  
       Mar 20, 2020 via Android
    没有代码
    lithiumii
        5
    lithiumii  
       Mar 20, 2020 via Android
    别的语言不一定,但特别长的 sql 肯定无法维护
    justfortest
        6
    justfortest  
       Mar 20, 2020 via Android
    没有代码最好维护,代码越简洁短小越好维护,有文档有注释的代码可维护性好
    CismonX
        7
    CismonX  
       Mar 20, 2020
    @lithiumii 深有体会,每当我负责维护离职同事写的数百行格式混乱的 ETL 时,都像吃了屎一样恶心。
    mayx
        8
    mayx  
       Mar 20, 2020 via Android
    我自己写的代码就是 unmaintainable 的
    mightofcode
        9
    mightofcode  
       Mar 20, 2020
    钱给到位
    都是 maintainable 的
    guyeu
        10
    guyeu  
       Mar 20, 2020
    能看懂的代码就是可维护的代码。
    ericls
        11
    ericls  
       Mar 20, 2020
    盈利的代码
    sicauxeon
        12
    sicauxeon  
       Mar 21, 2020
    仔细维护的注释、有意义的方法和变量名、SOLID 六大原则、单测覆盖、控制抽象层次使得代码像文章那样结构严谨层次分明。

    语言特定的话,最好 team 里大家都遵守同一份 best practice,例如阿里巴巴 Java 开发手册中那样的规约

    Bob 大叔的《代码整洁之道》和 Martin Fowler 的《重构》是非常不错的参考
    JerryCha
        13
    JerryCha  
       Mar 21, 2020
    可以针对任意的需求变更在交付日期之前保证 8*5 工作制不加班的情况下完成
    xcstream
        14
    xcstream  
       Mar 21, 2020
    新手不需要过多解释就能上手的
    levelworm
        15
    levelworm  
       Mar 21, 2020 via Android
    @CismonX 自动格式化一下
    EscYezi
        16
    EscYezi  
       Mar 21, 2020 via iPhone
    写注释 写注释 写注释,快被没有注释的代码恶心死了
    About   ·   Help   ·   Advertise   ·   Blog   ·   API   ·   FAQ   ·   Solana   ·   5487 Online   Highest 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 110ms · UTC 06:37 · PVG 14:37 · LAX 23:37 · JFK 02:37
    ♥ Do have faith in what you're doing.