"代码要有充分注释"这句话害了不少项目。它没说清楚"充分"是多少，于是有人给每一行都配一句中文翻译，评审时谁也不敢说不对——毕竟注释多一点总没坏处。 有坏处。注释和代码一样是要维护的资产，而且它比代码更容易腐化：代码错了测试会挂，注释错了没人知道…
1.7k
0
12
舒野 Published · 2026-09-30
#代码质量
7AA7 技术博客 · #代码质量 下的全部文章。
翻一遍多数项目的代码，错误处理基本只做了三件事里的一件：把错误往上抛。一个 try-catch 包住，打印一句日志，然后 throw new RuntimeException(e)，链路上每一层都这么来一遍。最后用户看到"系统繁忙"，开发看到二十行一模一样的堆栈。 完整的错误处理包…
1.8k
0
9
沈让 Published · 2026-09-29
"这块代码该重构了"很难争取到资源，它描述的是主观感受，而排期表上每一行都是可交付的功能。技术债管理的第一步不是动手重构，而是把感受翻译成能用同一套标准比较的东西——否则偿还永远排在交付之后，直到某天以故障的形式强制偿还。 债务先要分类 不同类…
1k
2
3
Liora Last reply · 2026-09-22