读别人代码这件事,几乎所有开发者都躲不掉。接手历史项目、做 code review、在开源仓库里定位问题、给老系统加功能,这些场景的核心技能不是写,而是读。我见过不少人写代码很溜,一让他解释某个模块的来龙去脉就开始支支吾吾,问题往往不是他不懂,而是读代码的方法不对。这篇东西我想把最近读代码的一些思考整理出来,话题集中在“怎么把一坨陌生代码读成自己脑子里的结构”,涉及切入方式、信息筛选、辅助工具、常见坑,以及一些相对软性但同样重要的东西。
1. 读代码,先分清你在读什么
1.1 代码的四种类型,决定了你的读法
拿到一段代码,第一件事不是扑上去一行行看,而是先判断它属于哪种类型。不同类型的代码,正确的打开方式完全不同。
第一类是业务逻辑代码,比如电商系统的订单处理、CMS 的内容发布流程。这类代码的特点是分支多、状态多、异常处理多,通常和人家的商业模式强绑定。你读它的目的是搞清楚“某个业务规则是在哪里落地、怎么落地的”。
第二类是算法/内核代码,比如某个推荐系统的排序算法、某个数据库的存储引擎、某个数值计算的库。这类代码的特点是逻辑集中、性能敏感、数学或数据结构含量高。读它的目的是理解核心机制和复杂度。
第三类是框架/基建代码,比如公司内部的 RPC 框架、日志组件、配置中心 SDK。这类代码的特点是抽象度高、接口多、扩展点密集。读它的目的是学会怎么用、怎么扩展,以及出问题时怎么排查。
第四类是脚本/胶水代码,比如部署脚本、数据迁移脚本、CI 配置。这类代码的特点是“用一遍就完”,通常不讲究什么设计模式,但往往藏着大量环境相关的隐性知识。读它的目的是搞清楚“当时到底做了什么、会不会影响我现在要做的事”。
1.2 我常用的代码阅读切入点
判断完类型之后,我会按类型选择切入点。
业务逻辑代码,我习惯先找“状态流转图”。不管是订单、审批、任务还是工单,业务代码的核心通常是状态机。找到定义状态的枚举、触发状态流转的方法、状态变更前后的校验,基本就掌握了这个业务的骨架。
算法内核代码,我习惯先找“数据结构定义”。算法代码的入口可能很复杂,但内核通常围绕某一个核心数据结构展开。比如读一个跳表实现,先搞清楚 Node 结构长什么样、层数怎么分配,代码基本就懂了一半。
框架/基建代码,我习惯先找“SPI/扩展点”。框架代码的入口往往是一堆抽
