准备学一项新技术时,手边往往已经有不少材料:一篇官方说明、几篇教程、一段跑过的代码,还有下载到电脑里的示例文件。真正要动手时,仍要重新想一遍:先看哪份,哪些结论已经试过,还有什么没有弄懂。
如果你正在建立个人知识库,可以先挑一个正在学的主题,把这些问题处理清楚。范围小一点,才容易判断这套方法是否适合自己。
下面用"理解 JavaScript 的异步执行顺序"做一个例子。你也可以换成接口鉴权、SQL 查询或其他正在学的内容。今天的目标是一份能继续学习的专题,不要求搬进过去所有资料。
先给这个专题写一个具体问题
"学习 JavaScript"太大,很难决定什么值得收进来。把它缩成"为什么这两行代码的输出顺序和书写顺序不同",资料范围就清楚多了。
一个合适的起点,通常同时包含三件事:你正在遇到的问题、可以亲手做的验证,以及希望留下的结果。例如,读完一段说明后运行一个小例子,再写下自己对执行顺序的解释。
先新建一页专题笔记,写出这几行:
text
专题:JavaScript 异步执行顺序
当前问题:哪些操作会晚于当前同步代码执行?
本次目标:跑通一个例子,并解释观察到的顺序
暂不展开:完整事件循环、性能优化和框架调度
"暂不展开"很有用。遇到相关内容时,你可以知道它值得以后研究,同时保住这次学习的范围。专题大小由当前问题决定,不必照搬一本书的目录。
三类材料,各自留下不同的东西
网页、自己的笔记和文件可以放在同一个主题下,但它们承担的任务不同。
| 内容 | 值得留下什么 | 下次怎样使用 |
|---|---|---|
| 教程或说明页面 | 名称、原始网址、与你的问题有关的用途 | 回到原文核对条件和上下文 |
| 实践笔记 | 运行方法、实际结果、自己的解释和疑问 | 复查哪些判断已经验证 |
| 示例文件 | 能再次打开的原文件及其用途 | 重新运行、比较或补充实验 |

保存书签时,描述可以只有一句:"这里解释了 Promise 回调的执行时机,准备对照实验。"这句话能帮你判断为什么要回来读它。
书签通常保留的是入口。保存了网址,不代表整篇网页已经保存下来;需要保留正文时,应另行确认实际存档结果。文件也一样,上传后要打开确认,不能只看进度条走完。预览支持哪些格式,以使用的工具提示为准。
自己的笔记则尽量写下思考过程。原文已经解释得清楚的地方,可以保留出处和简短摘录,把主要精力留给"我怎样验证"和"我还不能解释什么"。
让专题笔记成为一个可读的入口
给三类材料加上同一个主题标签,或在专题笔记里写清它们的名称与位置,就能先建立一条简单的阅读路径。
专题入口最好告诉下次打开它的人------也就是未来的自己------应该从哪里继续。下面的结构已经足够开始:
text
我现在想弄懂的问题:
先读哪份说明:实际保存的书签名称
做过的验证:实际保存的实践笔记名称
需要的文件:文件名称、用途或保存位置
目前能解释的部分:
还没确认的部分:
下次继续:一个具体动作
这里的名称和位置需要换成你自己的实际材料。有明确的资源关联入口时,可以直接关联;暂时没有,也可以先写清名称,再通过搜索或主题标签找回。

不必在第一天设计一套复杂的分类体系。先让这个专题中的每份材料有用途,让笔记能把它们连起来。是否需要更细的目录,可以等资料真的增加后再判断。
做一次小验证,让笔记里出现自己的证据
把下面的代码放进浏览器开发者工具的控制台,或在本地 JavaScript 运行环境中执行:
javascript
Promise.resolve().then(() => console.log('B'));
console.log('A');
这个例子会先输出 A,再输出 B。它只演示一个很小的执行顺序,不能据此概括所有异步行为。
在知识库里,可以把记录写成下面这样:
text
实验目的:观察 Promise 回调与当前同步代码的先后
运行环境:填写实际浏览器或运行时及版本
操作:执行上面的两行代码
预期:先输出 A,再输出 B
实际结果:运行后如实填写
我的解释:对照所读说明,用自己的话补充
尚未验证:换成其他异步来源时会怎样

"实际结果"请在运行后填写。先写预期,再记录观察结果,有助于看见自己理解上的差距。结果不符合预期时,保留当时的代码、环境和输出,继续缩小问题。
这份笔记以后还可以补充。比如换一种写法再试一次,或找到更准确的解释后修改结论。更新时留下适用条件,比只把结论改成"正确答案"更方便复查。
把确定、推测和疑问分开
专题积累到几份材料后,很容易把"文章这样说"和"自己已经验证"写在同一个段落里。可以给结论补一小段状态说明:
- 已观察:在某个明确环境中看到了什么。
- 待核验:目前理解是什么,还缺哪项验证。
- 适用条件:这个结论针对什么版本、输入或前提。
这几行由你自己维护,不要求工具自动判断。AI 可以帮助梳理表达,但涉及版本、运行结果和适用条件,仍要回到原文及实验核对。使用 AI 能力时,也要留意实际额度和材料读取范围。
如果几篇材料说法不同,先把差异并排写下来,检查发布时间、版本和讨论的问题是否一致。暂时解释不清的地方可以保留疑问,不必为了让知识库看起来完整而填入猜测。
用十分钟做出第一个能继续的专题
这次尝试只需要少量材料:
- 选一个具体问题,创建专题入口。
- 保存一篇准备细读的说明,补一句用途。
- 新建一份实践笔记,记录一个小验证。
- 有需要时加入一份示例文件,并打开确认。
- 从专题入口找到材料,写下一次准备做的动作。

十分钟未必足够学懂这个主题,但足够检查这套组织方式是否能帮你继续。验收时看三个具体结果:原文能找回,验证过程能读懂,下一步清楚到可以直接动手。
如果这个专题还用不上文件,先保留书签和笔记即可;如果当前问题只需要一份笔记,也可以从那里开始。材料类型服务于学习任务,不需要为了展示功能把每个入口都填满。
下次继续学习时,先打开这一页。你可以补一项验证、修正一句解释,或关闭一个疑问。几次之后,再决定是否把同样的方法用到下一个主题。第一份专题留下的结构,也会成为你自己的知识库模板。
这篇内容里的部分实践,来自我长期维护的一个开源项目。如果你对这些做法的实现感兴趣,可以参考仓库: