Atom 默认不显示缩进参考线，需手动开启 showIndentGuide 配置项；若开启后无效，多因文件未被正确识别语言上下文；配合 .editorconfig 可提升可靠性，原生功能已满足基础嵌套层级查看需求。
showIndentGuide 配置项必须手动开启
Atom 默认不显示缩进参考线，不是 Bug，是原生关闭状态。关键配置项叫 showIndentGuide，拼成 showIndentGuides、indentGuides 或 showIndentation 都无效。
操作路径：按 Ctrl + ,（Windows/Linux）或 Cmd + ,（macOS）→ 切到 “Editor” 标签页 → 勾选 Show Indent Guide（中文界面下名称）。
- 该设置仅控制开关，不提供颜色、粗细、虚实等样式选项
- 若勾选后无反应，大概率不是设置问题，而是 Atom 没识别出当前文件的缩进结构（见下一条）
- 无需重启，但已打开的文件需重新触发渲染（如切换标签页或重载窗口
Window: Reload）
缩进线不显示？先确认 Atom 能解析你的文件
90% 的“开了没反应”源于 Atom 未正确加载语言上下文，导致无法推导缩进层级。常见失效场景：
- 文件后缀名未被识别（如
.txt、.log、无后缀文件）→ Atom 不激活语法高亮 →showIndentGuide不生效 - 文件开头含 BOM 字节或非法不可见字符 → language-* 包加载失败 → 缩进上下文丢失
- 混用空格与 Tab：设了
Tab Length = 4，但实际代码用 2 空格缩进 → Atom 按 4 格对齐，线“偏移”，看起来像没对上
快速验证：新建一个 .js 文件，输入 if (true) { console.log('ok'); }，看大括号是否对齐出现竖线。若能显示，说明设置有效，问题出在目标文件本身。
配合 .editorconfig 才能让缩进线真正可靠
单靠 Atom 设置只能管本地编辑器行为，换机器、拉别人项目、CI 流水线跑格式检查时全失效。真正让缩进线“反映真实意图”的方式，是把规则写进项目本身。
- 在项目根目录建
.editorconfig，内容示例：[*] indent_style = space indent_size = 2
- 安装
editorconfig插件（非强制但强烈建议），它会自动读取并同步Tab Length和Soft Tabs设置 - 这样缩进线不仅显示了，还和
ESLint、Prettier、Black等工具对齐，避免“看着有线，保存后全乱”
注意：editorconfig 优先级高于 Atom 全局设置，也高于 language-* 插件的硬编码规则（比如 language-python 默认设 2 空格）。
别装 indent-guide-improved，除非你明确需要动态对齐
Atom 原生 showIndentGuide 是静态层级映射，性能好、稳定、大文件（>10k 行）滚动不卡顿。而插件如 indent-guide-improved 提供括号对齐、自定义颜色等能力，但代价明显：
- 在 Atom 1.60+ 后兼容性变差，部分用户反馈滚动卡顿、光标跳动
- 它会覆盖原生逻辑，一旦出问题很难回退——禁用插件后，原生缩进线不会自动恢复（需手动重载窗口）
- 不支持
editorIndentGuide.activeBackground这类 VS Code 式精细控制，所谓“自定义”仍受限于 Atom 渲染机制
如果你只是想看清代码块嵌套层级，原生功能已足够；真需要括号对齐或颜色区分，优先考虑换用 VS Code 或 WebStorm——Atom 的架构不适合这类深度定制。
