xhacker
V2EX  ›  随想

让别人读懂你的代码

  •  
  •   xhacker · Oct 23, 2010 · 6624 views
    This topic created in 5683 days ago, the information mentioned may be changed or developed.
    原先一直是自己写东西。

    最近加入了一些开源项目。
    自己的一些所谓的“项目”也有了别人接手。

    别人的代码对我来说总是恐怖的。
    相信我的代码对别人来说也是恐怖的。

    ……
    所以,
    能让别人读懂你的代码,
    估计是最高境界了。
    7 replies    1970-01-01 08:00:00 +08:00
    no2x
        1
    no2x  
       Oct 23, 2010
    注释 是必须也是很重要的。开发文档,最好有文件简介。
    darcy
        2
    darcy  
       Oct 24, 2010
    的确,要想代码写得优雅不是一朝一夕的事情
    FRHong
        3
    FRHong  
       Oct 24, 2010 via iPhone
    http://liuming.javaeye.com/blog/776890

    You might be interested in this :)
    ratazzi
        4
    ratazzi  
       Oct 24, 2010
    现在觉得命名非常的重要,好的命名基本上不需要什么注释,主要是针对 PHP 来说,比如 Magento 的代码比起那些 vanilla 好读很多。
    Sam
        5
    Sam  
       Oct 24, 2010
    想起那个搞笑的注释:
    只有上帝和我看得懂。
    现在,只有上帝看得懂了。


    刚学编程的时候写的代码,从不注释,过了几天,自己都看不懂了。
    lik
        6
    lik  
       Oct 24, 2010 via Android
    编程就是和机器以及人类交流(项目合作者、几天后的自己)啊。
    cellsea
        7
    cellsea  
       Jan 12, 2011
    为什么我从来都看得懂自己的代码呢? 我从来不写注释的。。。 是我写的代码太简单了吧??。。。
    About   ·   Help   ·   Advertise   ·   Blog   ·   API   ·   FAQ   ·   Solana   ·   3041 Online   Highest 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 41ms · UTC 06:26 · PVG 14:26 · LAX 23:26 · JFK 02:26
    ♥ Do have faith in what you're doing.