Sublime的detect_indentation仅在文件首次打开时扫描前200行，若首行缩进为\t则强制设translate_tabs_to_spaces为false，忽略用户设置；常见干扰源包括.editorconfig、语法特定设置及Vim注释；验证需实测Tab行为并手动触发重检测；稳定配置应分层控制：全局关闭自动探测，用户级写死tab_size和translate_tabs_to_spaces，再按语法或项目单独覆盖。
Sublime 的自动检测缩进（detect_indentation）默认开启，但实际是否生效，取决于它有没有被悄悄关掉、覆盖或绕过——多数人以为“开了就自动适配”，结果按 Tab 还是插 \t，右下角显示 Tab Width: 4 却没标 Spaces: 4，本质是 translate_tabs_to_spaces 被设成了 false。
为什么 detect_indentation 看似开着却没用
它只在文件首次打开时扫描前 200 行，一旦发现首行缩进是 \t，就强制把 translate_tabs_to_spaces 设为 false，把你用户设置里的 true 直接忽略。常见干扰源有：
-
.editorconfig文件里写了indent_style = tab，EditorConfig 插件会劫持并覆盖所有原生设置 - 当前文件绑定了语法（如 Python），而该语言的
Python.sublime-settings没显式声明translate_tabs_to_spaces，就会 fallback 到语法包默认值（常为false） - 文件顶部有 Vim 风格注释，比如
# vim: set ts=2 sw=2:，Sublime 会优先读取它，跳过自动探测 - 状态栏只显示
Tab Width: 4，但旁边没写Spaces: 4或写着Spaces: Off，说明空格转换根本没启用
如何验证 detect_indentation 是否真在工作
别只看设置里有没有 "detect_indentation": true，要实测行为：
- 按
Ctrl+Shift+P输入Set Syntax: Plain Text，切到纯文本模式，再按Tab—— 如果这时出的是空格，说明问题出在语法或插件上 - 关闭当前文件，删掉项目根目录的
.editorconfig（或临时重命名），再重新打开，观察右下角是否出现Spaces: 4 - 手动触发重检测：按
Ctrl+Shift+P输入detect_indentation回车，它不会改代码，只更新当前视图的插入模式和缩进参考线
想让不同项目/文件类型稳定适配，不能只靠 detect_indentation
它本质是启发式猜测，不是声明式规则。混合项目里，同一目录下 .py 和 .js 可能被检测出不同缩进；老文件开头全是注释，它直接放弃判断，退回到全局默认。更可靠的做法是分层控制：
- 全局关掉自动探测：
"detect_indentation": false，避免它“好心办坏事” - 用户设置里写死基础值：
"tab_size": 4和"translate_tabs_to_spaces": true - 对每种语言单独配置：点右下角语法名 →
Open Syntax Specific Preferences，在Python.sublime-settings或JavaScript.sublime-settings里重复写那两行 - 项目级统一？加
.sublime-project文件，在settings字段里覆盖缩进参数，优先级高于用户设置
已有混用缩进的文件，detect_indentation 不会帮你修复
它只管“接下来按 Tab 怎么插”，不管已有内容。状态栏提示 Mixed indentation detected 时，Sublime 会禁用自动转换，必须手动清理：
- 先全选（
Ctrl+A），再按Ctrl+Shift+P输入Indentation: Convert to Spaces—— 这个命令只处理行首缩进，不碰字符串里的\t - 如果转换失败，说明前几行缩进太乱，先手动删掉几行开头的
\t或空格，再重试 - 转换后记得检查是否误伤了多行字符串或注释里的对齐空格——
Convert to Spaces不做语义判断
真正麻烦的不是设错参数，而是多个配置层（全局 / 语法 / 项目 / EditorConfig / 文件内注释）之间互相覆盖，且没有直观的“生效链路”提示。调完之后一定要打开新文件、切换语法、从命令行用 subl 打开，多场景验证右下角状态栏的实际输出。
