技术博客 / 深度长文
文档定位:本文用于把
<topic>讲清楚给外部读者,同时保持工程严密性、结构分层和证据意识。 适用读者:对<topic>有兴趣、需要理解背景、实现、权衡与结论的读者。 写作原则:博客允许叙事性,但不允许牺牲定义、引用、目录、图注、公式解释与明确结论。
摘要
用 3~6 句说明:
- 这篇文章讨论什么
- 为什么值得看
- 最核心的结论是什么
- 文章适合谁
目录
1. 背景
1.1 主题背景
1.2 为什么值得关心
1.3 这篇文章不讲什么
2. 问题定义
2.1 文章要回答的问题
2.2 适用边界
3. 核心概念与术语
| 术语 | 定义 | 备注 |
|---|---|---|
<term> |
<definition> |
<note> |
4. 系统或方案拆解
4.1 总体结构
<component-a>
-> <component-b>
-> <component-c>4.2 分层说明
4.3 主链路说明
5. 关键实现细节
5.1 关键机制
5.2 关键代码 / 配置 / 数据结构
5.3 关键公式
如果需要公式,按下面格式写:
S = \alpha Q + \beta C + \gamma T并跟一张变量表:
| 符号 | 含义 |
|---|---|
S |
<meaning> |
Q |
<meaning> |
以及一段自然语言解释。
6. 图片图表与证据
6.1 图片 / 截图插入规范
推荐每张图都按下面格式写:

图 1:<图标题>。说明这张图证明什么。来源:<原创截图 / 官方文档 / AI 生成示意图 / 外部来源链接>。6.2 图表说明
6.3 证据说明
区分:
- 运行截图证据
- 架构示意图
- 对比图表
- AI 生成示意图
7. 对比与权衡
| 维度 | 方案 A | 方案 B | 结论 |
|---|---|---|---|
<dimension> |
<summary> |
<summary> |
<conclusion> |
8. 常见误区
<misunderstanding>
9. 结论
9.1 主结论
9.2 给不同读者的建议
9.3 保留意见
10. 参考与附录
10.1 参考来源
[官方] <title>, <version/date>[代码] <repo/file/module>[实验] <environment/date/method>[推断] <why this is inference>
10.2 附录
- 补充图
- 扩展样例
- 长表