Atom官方文档已归档，现仅存于GitHub的atom/flight-manual.atom.io仓库中，需克隆后用Python本地起服务（python3 -m http.server 4000）离线查看，核心配置与包开发相关内容仍有效。
Atom 的官方文档在哪找，为什么直接搜不到
Atom 官方早已停止维护，flight-manual.atom.io 域名在 2022 年下线，现在访问会跳转 404 或重定向到 GitHub 存档页。这不是你网络或浏览器的问题，是文档本身被归档了。
真正能用的最新版手册，只存在于 GitHub 的 atom/flight-manual.atom.io 仓库中，且仅以静态网页形式存在——必须本地构建，或靠第三方镜像。
常见错误现象：
• 搜索 “Atom Flight Manual” 出来的全是过期链接或失效博客
• 点击官网 atom.io 的 “Docs” 跳转到空页面或 404
• 用 atom --help 只显示 CLI 参数，不包含编辑器功能说明
怎么离线查看完整 Flight Manual（含搜索和跳转）
最稳的方式：克隆仓库 + 本地起服务。GitHub 上的 atom/flight-manual.atom.io 是 Jekyll 项目，但不用装 Ruby，用现成的 Python HTTP 服务就能预览。
实操步骤：
• 运行 git clone https://github.com/atom/flight-manual.atom.io.git
• 进入目录后执行 python3 -m http.server 4000（Python 3.7+ 自带）
• 浏览器打开 http://localhost:4000，即可全文搜索、点击导航、查看所有章节（如 using-atom、hacking-atom）
• 注意：部分图片路径在本地服务下可能 404，不影响文字内容阅读
性能影响：无需编译，加载快；兼容性无问题，纯静态 HTML/CSS/JS。
哪些文档内容现在还真正有用
不是所有旧文档都过时。Atom 的核心机制（如 config.cson 结构、init.coffee 加载逻辑、keymap.cson 绑定规则）至今仍适用于仍在运行的 Atom 实例。
值得重点看的章节：
• configuring-atom：讲清楚 ~/.atom/config.cson 各字段含义，比如 core.excludeVcsIgnoredPaths 控制是否隐藏 Git 忽略文件
• keymaps-in-depth：解释 selector 匹配优先级，避免写错 .platform-darwin 导致快捷键不生效
• creating-a-package：虽然 API 已冻结，但包结构、package.json 字段、activationHooks 触发逻辑仍准确
容易踩的坑：
• 别看 releases 或 blog 目录下的文章，全是历史公告
• hacking-atom 里提到的 Electron 版本（如 1.6.x）已严重过时，对应调试方式不可照搬
有没有更轻量的替代查法（不拉仓库）
如果只是查某个函数或配置项，别硬啃整站文档。GitHub 仓库自带搜索，效率更高：
• 在 atom/flight-manual.atom.io 页面右上角点 Search code
• 输入关键词，比如 autocomplete-plus 或 editor.fontSize，直接定位到 Markdown 源文件
• GitHub 会高亮匹配行，点进去就能看上下文说明（通常比网页渲染版更干净）
• 配合浏览器「查找」（Ctrl+F），可快速过滤掉模板文字，直奔参数定义段落
注意：不要依赖 Atom 内置的 Cmd+Shift+P → “Open Your Config”，它只开 config.cson，不提供文档解释。
复杂点在于，Flight Manual 里很多概念（比如 TextEditor 对象的生命周期）需要结合源码交叉验证，光看文档容易误解触发时机。真遇到行为异常，得去翻 atom/atom 主仓库的 src/text-editor.js 才算闭环。
