这是一个创建于 2044 天前的主题，其中的信息可能已经有所发展或是发生改变。
代码, 是把人的思维传递给计算机的工具, 所有的编程语言, 在设计时, 从没认真考虑过如何把一个人的思维传递给另一个人或者 2 个月后的编写者本人。
我们程序员不得不用一个工具, 强行去解决该工具设计时从没考虑到的问题, 这就是痛苦的根源。
编程是管理复杂度的工作, 复杂度分为问题本身需要的和工具本身带来的, 95%的编程工作, 后者的复杂度远远超过甚至碾压前者。
 | 1 zcbenz 2020-05-10 16:20:21 +08:00  6 我觉得更痛苦的是，别人乱改自己的代码 |
 | 2 ruby0906 2020-05-10 16:44:00 +08:00 3 所以，文档就显得越发重要。 但并没有引起人们的足够重视。 |
 | 3 xiaket 2020-05-10 16:46:33 +08:00 所以选一个好懂的编程语言很重要. |
 | 4 viator42 2020-05-10 16:51:22 +08:00 32 看到烂代码就骂哪个傻叉写的，最后一查是自己写的 |
 | 5 jdgui 2020-05-10 16:52:36 +08:00 安卓程序员的优越性，基本上代码都是我一个人写的。 然后 3 月那段时间 996 写出来的代码，我现在都不忍直视，骂又没地方可以骂。哈哈 |
 | 6 hoyixi 2020-05-10 16:54:25 +08:00 所以要有文档和流程方法论，不过我们不需要，因为勤劳吃苦奋斗的中国人可以加班 |
 | 8 loading 2020-05-10 16:58:35 +08:00 via Android 3 写代码更大的痛苦, 在于理解自己以前的代码。 |
 | 9 MajestySolor 2020-05-10 17:09:51 +08:00 不说让别人理解了，光自己看都够呛 最好的方法就是自己每隔半年就重构一次 |
 | 10 whisky221 2020-05-10 17:18:49 +08:00 确实，读代码很累，但是理解了会有提升。 自己写很爽，但是提升细微（打字速度） |
 | 11 turi 2020-05-10 17:19:17 +08:00 我写代码喜欢 短小、紧凑的片段组合。 我同事，你为什么不写一个函数里面，也就一个功能，也不可能复用的，然后最后一句：几千行还好吧。 |
 | 12 hyy1995 2020-05-10 17:23:33 +08:00 如果业务复杂的话，自己的代码过了一段时间都看不懂了 |
 | 13 Nich0la5 2020-05-10 18:25:05 +08:00 via Android 写注释啊老铁们 |
 | 14 zhuawadao 2020-05-10 18:51:42 +08:00 1 程序员看代码--自己刚刚写的代码，啧啧啧，真是精妙； 别人的代码--这是什么垃圾代码； 看三个月之前自己写的代码--这是我写的吗，肯定谁改了，要不不可能这么垃圾。 |
 | 15 Xbluer 2020-05-10 19:00:35 +08:00 痛苦的根源就是楼主的第一句话。 如果大家把代码当作给另一个程序员传递思想的工具，那么就不会有这个烦扰了。 有句话：代码是给人看的，顺便能在计算机上运行而已。 |
 | 16 kaiki 2020-05-10 19:02:32 +08:00 2 写代码不加注释的都是耍流氓。 我自己写的代码不加注释第二天我都看不懂，所以我能注释都注释。 |
 | 17 jay0726 2020-05-10 19:23:34 +08:00 刚看的微博热搜，北京同仁医院眼科主任魏文斌：质检合格的电子产品都已过滤有害的短波蓝光。日常生活中，使用正规厂家生产的电子产品，没必要加装防蓝光的设备。 |
| 18 jay0726 2020-05-10 19:24:04 +08:00 抱歉发错了 |
 | 19 weizhiyao008 2020-05-10 19:31:54 +08:00 更痛苦的是别人乱改自己的代码后出了 BUG 还要自己查 |
 | 20 justin2018 2020-05-10 19:33:13 +08:00 2 修改别人的代码 ： 谁写的代码 太稀烂了 别人修改自己的代码：谁写的代码 太稀烂了 |
 | 21 JerryCha 2020-05-10 20:08:59 +08:00 说得好 让我再写一千行三目运算套三目运算套++a++再说 |
 | 22 charlieputon 2020-05-10 20:14:17 +08:00 via Android @jdgui 在一个几十个安卓开发的团队待过，你肯定想象不到那种感觉。。 |
 | 24 fortunezhang 2020-05-10 20:57:37 +08:00 以前觉得自己写的还 ok，自从接了一个维护项目以后，就开始写备注了。jetbrains 软件生成的 params 还是挺好看的。 |
 | 25 maomaomao001 2020-05-10 21:20:44 +08:00 @ruby0906 我实际体验过程中发现的一个问题，文档确实挺好， 但是在项目实际快速迭代过程中 ， 文档 和最版本代码一致性比较难以做到，你有没有方法优化这一类问题 ？ |
 | 26 kop1989 2020-05-10 21:29:30 +08:00 @maomaomao001 api 可以实现自动生成文档，但是逻辑和业务的备忘就无能为力了，要么自觉直接写注释，要么纪律上要求。比如 check in 的时候备注必须描述自己新增、修改的逻辑，或者必须附带文档一起 check in 。 也希望大佬共通赐教。 |
 | 27 dioxide 2020-05-10 22:12:07 +08:00 所以才有了代码规范、范式、“军规”.. |
 | 28 blless 2020-05-10 22:13:28 +08:00 via Android go 程序员扬眉吐气 |
 | 29 liliumss 2020-05-10 22:26:52 +08:00 所以代码 review 非常重要，如果每个程序员写的代码都遵循 《 clean code 》，那代码读起来就不会那么费劲了 |
 | 30 feelcodex 2020-05-11 01:21:43 +08:00 via iPhone 最惨的是：别人写的代码出了 BUG，然后让你去修。。。 |
 | 31 dayeye2006199 2020-05-11 02:22:48 +08:00 1 我觉得更痛苦的，是三个月之后看自己的代码。。这 TM 什么玩意儿。。 |
 | 32 ijrou 2020-05-11 02:48:16 +08:00 我觉得最痛苦的莫过于别人挖坑挖到自己的家里来了。。。。。 |
 | 33 icylogic 2020-05-11 03:11:32 +08:00 1 30 楼了居然都没有提到测试二字，保证一定覆盖率的有意义的测试才是理解代码，快速接手 legacy code （包括自己写的）的最佳方式。 从时效性看，文档（包括自动生成的）很难保持和代码的同步，注释稍微好一点，但也极度依赖于每个人自觉，只有能通过的测试才是永不过时的。所以文档适合描述比较稳定的公开接口。测试有和代码同步的时效性，而且粒度可以远比文档细，又不像注释那样难以规范和保证覆盖。 注释，代码风格 /规范，命名，review，linter，这些都是有效的辅助手段，但是我认为对于 maintainability 来说，最重要的就是测试。 有本书叫 working effectively with legacy code 可以看看。 |
 | 34 PlanZ 2020-05-11 05:10:15 +08:00 持续优化自己的代码，就不会忘了，还能发掘潜能。 |
 | 35 kinghly 2020-05-11 08:23:15 +08:00 via Android 代码可以阅读性很重要 |
 | 36 qloog 2020-05-11 09:04:24 +08:00 所以 代码风格 /规范，命名，review，linter 对于一团队很重要，再加上单元测试就基本可以保证功能的稳定性。 |
 | 37 fancy111 2020-05-11 09:07:25 +08:00 你搞错了吧，任何人写的代码包括你自己，过段时间去看也是难看懂的。 但是只要你精通这门语言，花点时间就看懂了，这并不是什么障碍。 如果你还觉得困难，那是你技术水平还不够。 |
 | 38 ultimate 2020-05-11 09:14:46 +08:00 写代码最大的痛苦之一，命名 |
 | 40 22yune 2020-05-11 09:26:21 +08:00 @zcbenz 我觉得更痛苦的是，别人乱改自己的设计。为抢功改一些他以为‘’没关系’的点，然后他还是领导，要你按他的设计实现。 |
 | 41 Techzero 2020-05-11 09:35:26 +08:00 via Android 命名不规范+没注释。。 |
 | 42 jinliming2 2020-05-11 09:38:18 +08:00 via iPhone 所以，你为什么不写注释 doc ？ |
 | 43 aaronhua 2020-05-11 09:42:10 +08:00 注释+文档很重要，毕竟你看的代码很多都是自己以前的代码 |
 | 44 sagaxu 2020-05-11 09:46:27 +08:00 via Android 最近半年我在把几万行反编译出来的代码移植到别的平台，因为是专业软件，功能都不懂，要从反编译代码倒推出功能，再正向重写出来。翻译了几千行之后，我已经很习惯读到处 goto 的代码了。 |
 | 45 a1562619919 2020-05-11 09:54:39 +08:00 via Android 写代码要看别人代码是指项目交接的情况吗？ 如果原作者不是大佬，我一般在搞定难点重点后全部重写一遍。可能效率偏低但是开发心情好多了 |
 | 46 Tonni 2020-05-11 09:59:23 +08:00 注释 + 文档，详细记录内部逻辑细节，这样以后维护起来会方便很多。 |
 | 47 sdushn 2020-05-11 10:20:49 +08:00 前几天重构自己刚入行时写的代码，恶心了好几天 |
 | 48 no1xsyzy 2020-05-11 10:50:34 +08:00 @xuanwu #7 命名并不能解决问题，英文母语使用者拿英文也不能缓解的问题，指望中文母语使用者用中文有任何程度的缓解都是妄想。 |
 | 49 paoqi2048 2020-05-11 10:59:40 +08:00 “好的代码不需要注释”，这句话不全对，注释和文档还是不能偷懒不写 |
| 50 maomaomao001 2020-05-11 11:10:54 +08:00 @kop1989 额,api 文档是前后端沟通性文档 这个太容易同步, 因为只要不同步,前端接的时候出问题会找相关人员同步 , 我主要面临的是,单纯的 前端程序的文档 , 或者后端系统本身的文档 , 怎么和自身的代码同步好呢 , 我暂时也没有找到好的办法 |
 | 51 MaxTan 2020-05-11 11:17:50 +08:00 其实读别人的代码挺有意思的啊 好的代码： "卧槽，流批啊。 还可以这样" 烂的代码： "哈哈，这傻" |
 | 52 lzihua 2020-05-11 11:27:43 +08:00 从业者平均水平高低问题。一个尖子班 老师讲题 很多就直接跳过了 略过了 |
 | 53 zshneedmoney 2020-05-11 11:36:52 +08:00 我感觉业务更苦难一些。代码难道比业务还复杂吗 |
 | 54 liveoppo 2020-05-11 12:00:18 +08:00 在写代码的时候，清晰易懂应该是重要考虑项，而不仅仅是各种精妙 |
 | 55 cabing 2020-05-11 13:09:39 +08:00 这个问题，ruby 之父考虑过，所以有了 ruby |
 | 57 peachpeach 2020-05-11 13:43:40 +08:00 是的，尤其是 shit 一样的代码，可读性非常的烂。 每次解 bug 读到这样的代码，都让人觉得很烦躁。 尤其是代码风格很烂的，写的时候完全不在意后面是不是有人会读。 C 语言。 |
 | 58 fkdog 2020-05-11 13:53:57 +08:00 听过一个词吗？ 文人相轻。 写代码同理，你认为别人写的烂，别人一样认为你写的烂。 |
 | 59 jones2000 2020-05-11 14:45:40 +08:00 读代码也是程序员的一个基本技能， 任何一个已经上线运行 1-2 年的程序的代码都有它存在的意义，就算你重写也需要看懂老代码， 重点就是看他踩过的坑，解决这些坑的代码可能就是代码里面最烂的一部分。 |
 | 60 yuxing1171 2020-05-11 15:26:16 +08:00 来，互相伤害。 |
 | 61 siteshen 2020-05-11 15:27:48 +08:00 理解别人的代码确实很困难，因为这不止取决于看代码的人，还取决于写代码的人。 但要做到以后能理解自己的代码还是能做到的： 1. 尽量用最高的标准要求自己的代码； 2. 不那么明显的工具函数会有简单的测试； 3. 不得不 HACK 的代码会用注释写明原因。 不夸张的说，我现在还能较容易地看懂我三年前写的代码。 |
 | 62 la2la 2020-05-11 16:25:11 +08:00 同感，接手一个业务比较复杂的 python 代码，也没啥高级的语法，但是上来给来了 6 个全局变量，真的吐了。还是多线程的程序，根本不知道什么时候填充，什么时候修改，只能一行行 DEBUG，多线程环境下面 DEBUG 简直吐了 |
 | 63 Orenoid 2020-05-11 16:32:07 +08:00 有时候适当读点别人的代码，有助于意识到自己的代码烂在哪。。 |
 | 64 NoKey 2020-05-11 16:46:28 +08:00 是不是你们提交 git 的时候，都不好好写 commit 的？ |
Select Language