sublime text 不支持跨文件批量转换 tab 为空格，必须分新输入设置和已有文件清理两步处理；convert indentation to spaces 仅作用于当前视图，受 .editorconfig、detect_indentation 和语法识别影响。
Sublime Text 本身不支持跨文件批量转换 Tab 为空格，所谓“一键全项目处理”是错觉。必须分两层解决：一是让新输入走空格，二是对已有文件逐个或用命令行批量清理。
为什么 Convert Indentation to Spaces 只对当前文件生效
这个菜单命令（Convert Indentation to Spaces）本质是视图级操作，只作用于当前打开的 View 实例，不扫描项目目录、不遍历未打开文件。它也不区分语法类型——哪怕你正编辑的是 .py，只要当前视图没被识别为 Python（比如右下角显示 Plain Text），缩进换算就可能出错。
常见错误现象：
- 执行后右下角仍显示
Tabs: 4，说明该文件已被.editorconfig锁定或detect_indentation强制接管 - 缩进看起来“错位”，是因为当前
tab_size值和文件原有 Tab 宽度不一致（比如文件里原是 8 列 Tab，而你设了"tab_size": 2，结果一个 \t 被换成 2 个空格） - 嵌套结构（如 Python 的
if+for+try多层缩进）出现对齐偏差，往往因混用了 Tab 和空格，而该命令不做混合检测，只机械替换行首 \t
如何安全批量处理整个 src/ 下所有 .py 文件
Sublime 原生不提供项目级缩进批量转换，但可以用系统命令行补足。注意：这不是“在 Sublime 里点一下”，而是退出编辑器后在终端执行。
Linux/macOS（推荐）：
find ./src -name "*.py" -exec sed -i '' 's/^[[:space:]]*//; s/^\t\+/\1/g; s/\t/ /g' {} \;
Windows（PowerShell）：
Get-ChildItem -Path ./src -Recurse -Filter "*.py" | ForEach-Object { (Get-Content $_.FullName) -replace "^\t+", " " -replace "\t", " " | Set-Content $_.FullName }
关键点：
-
sed -i ''中的空字符串''是 macOSsed必需参数，漏掉会报错 - 正则
^[[:space:]]*先清理行首已有的空格或 Tab 混合，避免重复缩进 -
s/\t/ /g把所有 \t 替换为 4 个空格，确保统一；若项目用 2 空格，改成" " - 不建议用
:%s/\t/ /g类 Vim 风格全局替换——它会误伤字符串、注释里的 \t
为什么改了用户设置，打开旧文件还是插 Tab
因为 Sublime 的 detect_indentation 默认为 true，打开文件时会扫描前 200 行，只要发现任意一个行首 \t，就强制把当前视图切到 Tab 模式，并忽略你的 "translate_tabs_to_spaces": true。
解决方法（三选一）：
- 在用户设置中加
"detect_indentation": false，彻底禁用自动检测 - 对已打开的旧文件，手动点右下角
Tab Width: 4→Convert Indentation to Spaces，再点Indent Using Spaces锁定模式 - 先用快捷键
Ctrl+Shift+P→ 输入Set Syntax: Plain Text，再执行转换，避开语法插件干扰
EditorConfig 插件正在悄悄覆盖你的设置
如果项目根目录有 .editorconfig，且含 indent_style = tab 或 indent_size = 2，EditorConfig 插件的优先级高于所有 Sublime 设置——你改再多用户配置都没用。
验证方式：
- 打开任意文件，按
Ctrl+Shift+P→ 输入EditorConfig: Show Info，看输出是否显示indent_style = tab - 临时禁用插件：
Ctrl+Shift+P→Package Control: Disable Package→ 选EditorConfig - 修改
.editorconfig：把indent_style = space和indent_size = 4写明确，比靠 Sublime 设置更可靠
真正麻烦的不是怎么转，而是你永远不知道哪一层配置在暗中生效：用户设置、语法专属设置、.editorconfig、甚至某个插件的隐藏开关。每次遇到“明明设了却不生效”，先查右下角状态栏，再查 EditorConfig: Show Info，最后看 Settings – Syntax Specific——三层漏掉一层，就白调了。
