写代码最大的痛苦, 在于理解别人的代码

• 資深大佬 : zcbenz

  我觉得更痛苦的是，别人乱改自己的代码

• 資深大佬 : ruby0906

  所以，文档就显得越发重要。 但并没有引起人们的足够重视。

• 資深大佬 : xiaket

  所以选一个好懂的编程语言很重要.

• 資深大佬 : viator42

  看到烂代码就骂哪个傻叉写的，最后一查是自己写的

• 資深大佬 : jdgui

  安卓程序员的优越性，基本上代码都是我一个人写的。
  然后 3 月那段时间 996 写出来的代码，我现在都不忍直视，骂又没地方可以骂。哈哈

• 資深大佬 : hoyixi

  所以要有文档和流程方法论，不过我们不需要，因为勤劳吃苦奋斗的中国人可以加班

• 資深大佬 : xuanwu

  试试用中文命名：
  https://www.v2ex.com/t/656566
  https://www.v2ex.com/t/615420

• 資深大佬 : loading

  写代码更大的痛苦, 在于理解自己以前的代码。

• 資深大佬 : MajestySolor

  不说让别人理解了，光自己看都够呛
  最好的方法就是自己每隔半年就重构一次

• 資深大佬 : whisky221

  确实，读代码很累，但是理解了会有提升。
  自己写很爽，但是提升细微（打字速度）

• 資深大佬 : turi

  我写代码喜欢 短小、紧凑的片段组合。

  我同事，你为什么不写一个函数里面，也就一个功能，也不可能复用的，然后最后一句：几千行还好吧。

• 資深大佬 : hyy1995

  如果业务复杂的话，自己的代码过了一段时间都看不懂了

• 資深大佬 : Nich0la5

  写注释啊老铁们

• 資深大佬 : zhuawadao

  程序员看代码–自己刚刚写的代码，啧啧啧，真是精妙；
  别人的代码–这是什么垃圾代码；
  看三个月之前自己写的代码–这是我写的吗，肯定谁改了，要不不可能这么垃圾。

• 資深大佬 : Xbluer

  痛苦的根源就是主的第一句话。

  如果大家把代码当作给另一个程序员传递思想的工具，那么就不会有这个烦扰了。

  有句话：代码是给人看的，顺便能在计算机上运行而已。

• 資深大佬 : kaiki

  写代码不加注释的都是耍流氓。
  我自己写的代码不加注释第二天我都看不懂，所以我能注释都注释。

• 資深大佬 : jay0726

  刚看的微博热搜，北京同仁医院眼科主任魏文斌：质检合格的电子产品都已过滤有害的短波蓝光。日常生活中，使用正规厂家生产的电子产品，没必要加装防蓝光的设备。

• 資深大佬 : jay0726

  抱歉发错了

• 資深大佬 : weizhiyao008

  更痛苦的是别人乱改自己的代码后出了 BUG 还要自己查

• 資深大佬 : justin2018

  修改别人的代码 ： 谁写的代码 太稀烂了

  别人修改自己的代码：谁写的代码 太稀烂了

• 資深大佬 : JerryCha

  说得好
  让我再写一千行三目运算套三目运算套++a++再说

• 資深大佬 : charlieputon

  @jdgui 在一个几十个安卓开发的团队待过，你肯定想象不到那种感觉。。

• 資深大佬 : dwzfuck

  @xuanwu 刚准备 @ /狗头

• 資深大佬 : fortunezhang

  以前觉得自己写的还 ok，自从接了一个维护项目以后，就开始写备注了。jetbrains 软件生成的 params 还是挺好看的。

• 資深大佬 : maomaomao001

  @ruby0906 我实际体验过程中发现的一个问题，文档确实挺好， 但是在项目实际快速迭代过程中 ， 文档 和最版本代码一致性比较难以做到，你有没有方法优化这一类问题 ？

• 資深大佬 : kop1989

  @maomaomao001 api 可以实现自动生成文档，但是逻辑和业务的备忘就无能为力了，要么自觉直接写注释，要么纪律上要求。比如 check in 的时候备注必须描述自己新增、修改的逻辑，或者必须附带文档一起 check in 。

  也希望大佬共通赐教。

• 資深大佬 : dioxide

  所以才有了代码规范、范式、“军规”..

• 資深大佬 : blless

  go 程序员扬眉吐气

• 資深大佬 : liliumss

  所以代码 review 非常重要，如果每个程序员写的代码都遵循 《 clean code 》，那代码读起来就不会那么费劲了

• 資深大佬 : feelcodex

  最惨的是：别人写的代码出了 BUG，然后让你去修。。。

• 資深大佬 : dayeye2006199

  我觉得更痛苦的，是三个月之后看自己的代码。。这 TM 什么玩意儿。。

• 資深大佬 : ijrou

  我觉得最痛苦的莫过于别人挖坑挖到自己的家里来了。。。。。

• 資深大佬 : icylogic

  30 了居然都没有提到测试二字，保证一定覆盖率的有意义的测试才是理解代码，快速接手 legacy code （包括自己写的）的最佳方式。

  从时效性看，文档（包括自动生成的）很难保持和代码的同步，注释稍微好一点，但也极度依赖于每个人自觉，只有能通过的测试才是永不过时的。所以文档适合描述比较稳定的公开接口。测试有和代码同步的时效性，而且粒度可以远比文档细，又不像注释那样难以规范和保证覆盖。

  注释，代码风格 /规范，命名，review，linter，这些都是有效的辅助手段，但是我认为对于 maintainability 来说，最重要的就是测试。

  有本书叫 working effectively with legacy code 可以看看。

• 資深大佬 : PlanZ

  持续优化自己的代码，就不会忘了，还能发掘潜能。

• 資深大佬 : kinghly

  代码可以阅读性很重要

• 資深大佬 : qloog

  所以 代码风格 /规范，命名，review，linter 对于一个团队很重要，再加上单元测试就基本可以保证功能的稳定性。

• 資深大佬 : fancy111

  你搞错了吧，任何人写的代码包括你自己，过段时间去看也是难看懂的。
  但是只要你精通这门语言，花点时间就看懂了，这并不是什么障碍。
  如果你还觉得困难，那是你技术水平还不够。

• 資深大佬 : ultimate

  写代码最大的痛苦之一，命名

• 資深大佬 : michaelso

  @Xbluer 不能同意更多了

• 資深大佬 : 22yune

  @zcbenz 我觉得更痛苦的是，别人乱改自己的设计。为抢功改一些他以为‘’没关系’的点，然后他还是领导，要你按他的设计实现。

• 資深大佬 : Techzero

  命名不规范+没注释。。

• 資深大佬 : jinliming2

  所以，你为什么不写注释 doc ？

• 資深大佬 : aaronhua

  注释+文档很重要，毕竟你看的代码很多都是自己以前的代码

• 資深大佬 : sagaxu

  最近半年我在把几万行反编译出来的代码移植到别的平台，因为是专业软件，功能都不懂，要从反编译代码倒推出功能，再正向重写出来。翻译了几千行之后，我已经很习惯读到处 goto 的代码了。

• 資深大佬 : a1562619919

  写代码要看别人代码是指项目交接的情况吗？
  如果原作者不是大佬，我一般在搞定难点重点后全部重写一遍。可能效率偏低但是开发心情好多了

• 資深大佬 : Tonni

  注释 + 文档，详细记录内部逻辑细节，这样以后维护起来会方便很多。

• 資深大佬 : sdushn

  前几天重构自己刚入行时写的代码，恶心了好几天

• 資深大佬 : no1xsyzy

  @xuanwu #7 命名并不能解决问题，英文母语使用者拿英文也不能缓解的问题，指望中文母语使用者用中文有任何程度的缓解都是妄想。

• 資深大佬 : paoqi2048

  “好的代码不需要注释”，这句话不全对，注释和文档还是不能偷懒不写

• 資深大佬 : maomaomao001

  @kop1989 额,api 文档是前后端沟通性文档 这个太容易同步, 因为只要不同步,前端接的时候出问题会找相关人员同步 ,
  我主要面临的是,单纯的 前端程序的文档 , 或者后端系统本身的文档 , 怎么和自身的代码同步好呢 , 我暂时也没有找到好的办法

• 資深大佬 : MaxTan

  其实读别人的代码挺有意思的啊
  好的代码： “卧槽，流批啊。 还可以这样”
  烂的代码： “哈哈，这傻屌”

• 資深大佬 : lzihua

  从业者平均水平高低问题。一个尖子班 老师讲题 很多就直接跳过了 略过了

• 資深大佬 : zshneedmoney

  我感觉业务更苦难一些。代码难道比业务还复杂吗

• 資深大佬 : liveoppo

  在写代码的时候，清晰易懂应该是重要考虑项，而不仅仅是各种精妙

• 資深大佬 : cabing

  这个问题，ruby 之父考虑过，所以有了 ruby

• 資深大佬 : ConradG

  @cabing 读别人的 Ruby 还不一定有读汇编来得轻松（逃

• 資深大佬 : peachpeach

  是的，尤其是 shit 一样的代码，可读性非常的烂。
  每次解 bug 读到这样的代码，都让人觉得很烦躁。
  尤其是代码风格很烂的，写的时候完全不在意后面是不是有人会读。
  C 语言。

• 資深大佬 : fkdog

  听过一个词吗？
  文人相轻。
  写代码同理，你认为别人写的烂，别人一样认为你写的烂。

• 資深大佬 : jones2000

  读代码也是程序员的一个基本技能， 任何一个已经上线运行 1-2 年的程序的代码都有它存在的意义，就算你重写也需要看懂老代码， 重点就是看他踩过的坑，解决这些坑的代码可能就是代码里面最烂的一部分。

• 資深大佬 : yuxing1171

  来，互相伤害。

• 資深大佬 : siteshen

  理解别人的代码确实很困难，因为这不止取决于看代码的人，还取决于写代码的人。

  但要做到以后能理解自己的代码还是能做到的：
  1. 尽量用最高的标准要求自己的代码；
  2. 不那么明显的工具函数会有简单的测试；
  3. 不得不 HACK 的代码会用注释写明原因。

  不夸张的说，我现在还能较容易地看懂我三年前写的代码。

• 資深大佬 : la2la

  同感，接手一个业务比较复杂的 python 代码，也没啥高级的语法，但是上来给来了 6 个全局变量，真的吐了。还是多线程的程序，根本不知道什么时候填充，什么时候修改，只能一行行 DEBUG，多线程环境下面 DEBUG 简直吐了

• 資深大佬 : Orenoid

  有时候适当读点别人的代码，有助于意识到自己的代码烂在哪。。

• 資深大佬 : NoKey

  是不是你们提交 git 的时候，都不好好写 commit 的？