遇到陌生开源项目，不要直接 clone 下来逐行读。按下面这个顺序，通常半天到一天就能理清脉络，知道怎么改、怎么用。
1. 先当用户，再当开发者
花 10 分钟把 README 和官方文档的 Quick Start 看完，重点关注三句话：项目是解决什么问题的、怎么安装、怎么跑起来。如果项目连 README 都写得含糊，要么太早期，要么维护者已经弃坑，投入前要慎重。
2. 一键跑起来
复制文档里的安装命令，本地编译或直接跑 Demo。能跑通说明环境没问题；跑不通立刻去 Issues 里搜报错信息，大概率有人踩过同样的坑。跑起来后，把自带的 example、sample、playground 都点一遍，建立直观体感，这比看一百行代码都管用。
3. 5 分钟扫目录结构
打开项目根目录，用 IDE 或 tree 命令扫一眼，快速定位：
- 入口：
main.go、cmd/、bin/、src/index.js等； - 核心逻辑：
pkg/、lib/、core/、internal/； - 配置与契约：
api/、proto/、config/、swagger.yaml； - 测试：
test/、*_test.go，测试是最好的使用文档。
不要深读，先在大脑里画一张“地图”，知道数据大概从哪进、从哪出。
4. 抓一条主链路，不要通读
代码量再大，核心流程通常只有一条。找准一个你关心的功能点，纵向跟到底：
- Web 服务 → 从 HTTP 路由跟到 Handler → Service → Repository/DB；
- 工具库 → 从对外暴露的 public API 跟到内部实现函数；
- CLI 工具 → 从
main()跟到命令解析（如cobra、argparse）→ 执行函数。
用 IDE 的调用链或断点跟一遍，画出时序图或脑图。搞懂一条线，其他都是变种。
5. 用测试当切入口
把项目测试跑起来，挑一个与目标功能相关的单元测试，单步调试。测试已经帮你把环境、mock 数据、上下文都构造好了，比直接读源码效率高得多。在关键节点改两个变量看看结果变化，很快就能摸清数据流转规则。
6. 带着问题读代码
不要漫无目的地“学习”。给自己定一个最小任务：
- “我想在日志里加一个字段”；
- “我想让这个命令支持一个新参数”；
- “我想解决一个 good first issue”。
带着问题去读，无关代码直接跳过。改完后用 git diff 看看自己都动了哪些文件，这些文件就是项目的关键触点。
7. 善用社区资产
- 翻
CHANGELOG.md，看最近几个版本的迭代方向； - 去 Issues 区搜
good first issue或help wanted，判断社区友好度； - 在 GitHub 或 Google 搜“项目名 + 你的场景”，看其他开发者怎么集成；
- 翻最近 1~2 个月的 Commit，作者正在写的模块通常就是当前维护重点。
8. 输出倒逼输入
看完默默关掉，一周后就忘了。花 30 分钟写一篇博客、整理一张架构图，或者在团队里做一次 10 分钟闪电分享。能用自己的话把项目的主流程和模块边界讲清楚，才算真正上手。