S19-B04 · 学习方法：开源项目与新技术怎么入门

适用读者：面对陌生仓库/陌生技术不知从哪下手的人。
前置：无。
口径：本篇为方法论述；两条补写内容来自两张空壳旧卡（各 6 点），标 E-S19-001/002。
覆盖旧文：A-2384（开源项目该怎么学，6 点空壳）、A-2361（安卓该怎么学，6 点空壳）= 12 点。
覆盖扩展：E-S19-001（开源项目学习法）、E-S19-002（新技术入门法）。
上一篇：S19-B03 · 语音输入：把需求说出来
下一篇：S19-X01 · 图像提示词。

1. 一句话结论

入门陌生系统只有一个原则：先建"可运行的入口"，再沿"改一个地方"扩张。 不要从读源码第一行开始。

2. 开源项目学习法（补写 `E-S19-001`）

2.1 三问法

问	目的	动作
① 它解决什么问题？	建立价值判断	读 README 首段 + 一张架构图
② 它怎么跑起来？	拿到可执行入口	按 Quick Start 跑最小示例
③ 我要改哪里？	定位入口	用"关键词搜代码"而不是通读

顺序不能反：先跑起来，再读代码。跑不起来的项目，读代码的效率接近零。

2.2 30 分钟"入口地图"

5 分钟：README + examples/ 目录 → 知道入口文件是哪个
10 分钟：跑通最小示例（docker compose up 或 make demo）
10 分钟：在你关心的功能上搜关键词，找到 1–2 个核心文件
5 分钟：画一张"输入 → 处理 → 输出"的三段草图

判据：能不能在图上标出"我要改的那一行大概在哪"。能 → 入门完成。

2.3 读源码的三个技巧

技巧	说明
从测试读起	测试是最可信的"用法说明"
从入口顺流而下	`main` / 路由注册 / 事件回调
用断点代替阅读	打一个断点，看真实调用栈（S01-J04）

3. 新技术入门法（补写 `E-S19-002`）

旧卡 A-2361 的题目是"安卓该怎么学"——它代表一类问题：某个生态怎么入门。抽象成通用法：

步	动作	目的
① 找官方入门路径	官方 tutorial / quickstart	避免跟错教程
② 做一个最小可交付	能跑的一个页面/一个接口	建立正反馈
③ 补概念缺口	只学"卡住你"的概念	避免无效通读
④ 做一次排障	故意制造一个错误并修复	把知识变成能力
⑤ 输出一页笔记	写给"三个月后的自己"	抗遗忘

判据：能不能独立做出第 ② 步。不能 → 说明入门材料选错了（不是你不聪明）。

3.1 安卓这类"生态型技术"的特殊性

特点	应对
概念多（Activity/生命周期/Manifest）	先学"一个页面怎么显示"，其余按需
工具链重（SDK/Gradle/模拟器）	环境先跑通（同 S01 的思路）
版本碎片化	只支持主流版本，明确最低 API
官方文档更新快	以官方文档为准，教程类只作参考

4. 五个误区

误区	真相
"先通读源码再动手"	跑不起来时读源码效率极低
"教程跟着做就会了"	不做排障就只是"抄过一遍"
"概念要一次性学全"	只学卡住你的，其余按需
"生态型技术要一次学完"	按"最小可交付"切片
"笔记就是抄文档"	笔记应写"我踩的坑 + 我的判断"

5. 自检

三问法的顺序为什么不能反？
30 分钟入口地图的四步是什么？
为什么"从测试读起"比从源码读起有效？
新技术入门的第 ② 步为什么是"最小可交付"？
生态型技术与单库技术在学习上的差异？

6. 下一篇

S19-X01 · 图像生成提示词的结构化写法

方法讲完，回到提示词。下一篇处理旧文的图像提示词卡：把"咒语"重组成"五维结构 + 负向词模板"。

本篇属于系列《S19 · AI 素养与学习方法》。旧文来源：A-2384/A-2361（两张空壳卡，本篇为补写内容，标 E-S19-001/002）。