用 2~3 句话说明:本文解决什么问题、采用什么方法、最终得到什么结果。这段也作为文章摘要,避免只重复标题
1. 问题与目标
背景:【在什么场景下遇到了什么问题?】
目标:【读完本文能够解释什么,或完成什么操作?】
范围:【本文讨论的版本、平台或实现;哪些相关问题留到其他文章?】
完成后的验收标准:
- 【可以直接观察或检查的结果一】
- 【可以直接观察或检查的结果二】
2. 前置知识与环境
需要先了解:【概念一】、【概念二】;必要时链接到已有笔记。
| 项目 | 本文使用的值 | 说明 |
|---|---|---|
| 操作系统 / 架构 | 【系统版本、x86_64 / ARM64 等】 | 【宿主机与目标环境分别说明】 |
| 工具 / 依赖 | 【名称及版本】 | 【关键编译选项或配置】 |
| 源码版本 | 【仓库、tag 或 commit】 | 【源码解析文章填写】 |
| 工作目录 | 【实际目录】 | 【后续相对路径的起点】 |
| 输入文件 | 【文件名与来源】 | 【下载、生成或自行编写】 |
3. 核心概念与整体流程
先用自己的话说明核心机制,再进入代码或操作细节。
| 概念 | 含义 | 在本文中的作用 |
|---|---|---|
| 【概念一】 | 【简明定义】 | 【它影响哪一步】 |
| 【概念二】 | 【简明定义】 | 【它与概念一的关系】 |
整体流程:
【输入 / 初始状态】 → 【处理阶段一】 → 【处理阶段二】 → 【输出 / 最终状态】
关键原因:【解释为什么采用这一流程,以及成立的条件。】
4. 实现过程
4.1 【步骤一:用动词描述要完成的事情】
目的:【这一步解决什么问题?】
操作位置:【在哪台机器、哪个目录、哪个终端或软件中执行?】
输入与操作:【需要准备什么;修改哪个文件、执行什么命令?】
【放入可复现的命令或最小完整代码】
关键解释:【解释重要参数、设计原因或状态变化;不逐行复述代码。】
检查点:【这一步成功后,应产生什么文件、输出或状态?】
4.2 【步骤二:用动词描述要完成的事情】
目的:【这一步与上一步的关系。】
操作:【命令、配置项或界面操作;截图中的关键值也写成文字。】
【放入命令、代码或配置】
检查点:【预期结果及其含义。】
5. 结果验证
验证方法:【具体执行什么命令,或在什么位置观察什么值?】
【验证命令或操作】
预期结果:
【关键输出、数值或状态;动态字段说明变化范围】
实际结果:【记录本次观察到的结果;未验证的内容明确标注。】
结论:【这些证据对应第 1 节的哪些验收标准?还有什么没有验证?】
6. 问题排查(可选)
6.1 【具体报错或异常现象】
- 现象:【报错原文、触发条件及发生步骤。】
- 定位:【检查了哪些日志、配置或状态?什么证据支持判断?】
- 原因:【根因;尚未确认时标注为推测。】
- 处理:【具体修改或替代方案。】
- 复验:【再次执行什么操作,得到什么结果?】
7. 总结与延伸
本文的核心结论:
- 【结论一:直接回答开头的问题。】
- 【结论二:值得复用的原理或方法。】
- 【结论三:适用条件或容易混淆的边界。】
下一步(可选):【尚待验证的问题或后续实验。】
8. 参考资料与关联笔记
- 【官方文档名称、链接】:用于核对【具体机制或参数】。
- 【源码仓库 / 版本 / 文件 / 函数、链接】:对应本文【某节】。
- 【前置或后续笔记标题、链接】:补充【相关知识】。
图片引入

pdf引入