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

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

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

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

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

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

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

试试用中文命名：
t/656566
t/615420

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

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

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

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

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

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

写注释啊老铁们

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

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

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

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

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

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

抱歉发错了

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

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

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

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

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

@xuanwu 刚准备 @ /狗头

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

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

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

也希望大佬共通赐教。

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

go 程序员扬眉吐气

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

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

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

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

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

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

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

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

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

代码可以阅读性很重要

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

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

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

@Xbluer 不能同意更多了

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

命名不规范+没注释。。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

来，互相伤害。

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

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

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

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

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

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