技术细节文章编写要点（Phodal 方法笔记）
ABSTRACT
2017-10 笔记（源自 Phodal 的技术文章写作方法论）：面向”寻找信息、想解决问题”的读者的技术细节文章模板——标题做 SEO（前半关键词后半意图），四段式结构（结论先行→客观事实与关键代码→图表增强→参考资料索引），30 分钟成稿、总长不超 2 小时，图片胜过文字，代码能少则少。
核心要点
- 定位：为假想读者群节约时间；素材来自日常工作问题（第三方库更新、浏览器 Bug、某技术怎么用）。
- 标题 SEO：前半部分放关键字，后半部分指明意图；命名重点是”解决的问题是什么”（如《Python 解决 InsecurePlatformWarning…》《Mac OS Laravel 安装》）。
- 四段式结构：第一段简单直接列解决方法（结论先行）；第二段列客观事实+关键代码块（代码多就放 GitHub；已消化的资料只讲最难理解的点）；第三段尽量加插图表格（可用 Markdown 快速画 UML）；第四段列高质量参考资料索引。
- 写法原则：以自己学习过程按步骤整理；表达部分细节便于理解、略去其余避免罗嗦；加一点个人感想防枯燥；面向解决问题的人，行文必须简洁。
- 通用规则：能用小篇幅说清原理绝不罗列代码；反之代码一目了然就不多费笔墨；图片胜过文字。
- 时间纪律：技术细节文章 30 分钟内写完，一篇博客总耗时不超 2 小时；时效性内容可在文末列遗留问题待将来解决。
关键实体与概念
- Phodal（方法论来源）；GitHub（代码托管配套）
- 结论先行、标题关键词 SEO、四段式技术文
关联概念
来源回溯
- 原始文件：
raw/ip/wechat_articles/1.技术细节文章.md（2017-10-20）
时效性评估
- 仍有效：结论先行、标题关键词+意图、代码托管外置、30 分钟/2 小时时间纪律，是技术写作的常青规范，对当前项目 dsz0（游戏开发）站的技术文有直接指导意义。
- 微调：如今还需考虑 AI 搜索（GEO）场景——结论先行的结构恰好也更利于被 AI 摘要引用。