convert indentation to spaces只处理行首缩进，按当前tab_size将\t换为对应空格数，不碰字符串或行中\t；菜单灰掉说明检测到混合缩进，需先清理异常行首缩进再执行。
Convert Indentation to Spaces 只处理行首缩进，不碰字符串里的 \t
这个命令不是全局查找替换，它只扫描每行开头的缩进部分，把制表符按当前 tab_size 值换算成空格。比如设了 "tab_size": 4，就每个 \t 换成 4 个空格；设成 2 就换 2 个。它完全忽略行中或字符串里的 \t，所以不会误伤日志格式、正则表达式或 SQL 字符串里的制表符。
常见错误现象：执行后发现缩进错位、Python 报 IndentationError。大概率是文件原本混用了 Tab 和空格——Sublime 检测到这种混合状态时，菜单会直接灰掉，不让你点。
- 先确认右下角状态栏显示的是
Spaces: 4（不是Tabs: 4），否则命令无效 - 如果菜单灰掉，手动删掉几行开头的
\t，再试一次 - 转换前建议用
View → Indentation → Detect Indentation看是否统一
多文件批量转：选中多个标签页 + 同步执行命令
Sublime 原生不支持目录级批量操作，但可以靠标签页多选实现“伪批量”：用 Ctrl+P（Win/Linux）或 Cmd+P（macOS）打开快速文件列表，按住 Ctrl（或 Cmd）点击多个 .py、.js 文件，全部在标签页中打开；然后对任意一个标签页执行 Convert Indentation to Spaces，所有已打开的选中标签页都会同步转换。
注意：这个机制依赖“当前视图的 tab_size 值”，不是文件实际缩进宽度。如果某个文件原始 \t 占 8 列宽，但你当前 tab_size 是 4，它就会按 4 个空格换，导致缩进塌陷。
- 务必先统一设置好语法专属配置（如 Python 文件必须进
Preferences → Settings – Syntax Specific写"tab_size": 4和"translate_tabs_to_spaces": true） - 转换后可补一句
Ctrl+Shift+P → Indentation: Reindent Lines，让 Sublime 重算逻辑层级 - 别依赖侧边栏多选文件后右键操作——那只是打开文件，不触发批量命令
真正跨文件批量：命令行比插件更可控
想处理整个 src/ 目录下的所有 .py 文件？Sublime 没有内置方案，硬上插件（如 BatchIndent）反而容易出兼容问题。推荐用系统命令行，POSIX 工具 expand 最稳妥：
find src/ -name "*.py" -exec expand -t 4 {} \; -exec mv {} {}.tmp \; -exec mv {}.tmp {} \;
这行命令会递归找到所有 .py 文件，用 expand -t 4 把行首 \t 换成 4 个空格（只动缩进，不动内容），并安全覆盖原文件。比 sed 's/^\t/ /g' 更可靠，因为 expand 天然识别制表位逻辑。
- 执行前先用
git add -N预览变更，确认没破坏嵌套结构 - Python 脚本方案（如
pathlib.Path('src').rglob('*.py')）慎用：replace('\t', ' ')是无差别替换，会污染字符串和注释 - 如果项目有
.editorconfig且含indent_style = tab，命令行操作不受影响，但 Sublime 内部会继续被劫持
为什么有些文件死活转不了？优先级三重覆盖是关键
你改了用户设置，也点了转换命令，但某个 .py 文件右下角始终显示 Tabs: 4，点它也没反应——问题不在命令本身，而在谁真正控制缩进行为。Sublime 的缩进决策链是：语法专属设置 > detect_indentation 自动推断 > 全局用户设置。Python 语言包默认硬编码 "translate_tabs_to_spaces": false，你全局写的 true 根本没机会生效。
- 打开该文件 →
Preferences → Settings – Syntax Specific→ 右侧只留两行："tab_size": 4和"translate_tabs_to_spaces": true - 必须加
"detect_indentation": false到用户设置里，否则一打开旧文件，Sublime 扫到前几行有\t就立刻切回 Tab 模式 - 改完语法专属设置后，已打开的文件需手动
Ctrl+Shift+P → Reload Syntax才刷新
最常被忽略的是：detect_indentation 关不掉，语法设置写得再全也白搭；而 .editorconfig 插件一旦启用，它的规则优先级又高于所有 Sublime 设置——得先确认插件是否装了、配置是否匹配。
