VSCode原生命令Convert Indentation to Spaces/Tabs仅作用于当前活动文件，不支持批量处理；真正批量缩进需依赖格式化工具（如Prettier/Black）配合formatOnSave或CLI命令实现，且必须关闭editor.detectIndentation以避免干扰。
VSCode 没有“一键批量转换整个文件夹缩进”的原生命令，所谓批量必须靠格式化工具驱动，而非手动点命令面板逐个执行 Convert Indentation to Spaces。
为什么命令面板里的 Convert Indentation 命令不能批量处理
该命令（Convert Indentation to Spaces 或 Convert Indentation to Tabs）只作用于当前活动编辑器中的单个文件。即使你用 Ctrl+Shift+P 调出它，输入回车，它也不会自动跳到下一个文件继续处理。
- 它不感知文件树、不扫描目录、不读取
.vscode/settings.json中的批量规则 - 右键文件资源管理器里的多个文件 → 选中 → 右键菜单里没有“批量缩进转换”选项
- 试图用
Ctrl+Shift+H全局搜索^\t并替换为空格，属于高危操作：会误伤字符串、正则字面量、注释里的\t，且无法按语义对齐（比如 5 个空格 + 1 个\t会被粗暴转成 9 个空格，破坏 Python 缩进层级）
真正能批量处理的唯一可靠路径：Format Document + formatOnSave
批量缩进重构的本质是让格式化工具接管——不是编辑器“改缩进”，而是“重排代码并顺带统一缩进”。这要求你已安装对应语言的 formatter 插件，并完成配置。
- 装好
Prettier（JS/TS/JSON/HTML/CSS）或autopep8/black（Python），确保它们在命令面板中可被识别为可用 formatter - 在项目根目录加
.prettierrc（示例）：{"useTabs": false, "tabWidth": 2, "semi": true} - 开启 VSCode 设置：
"editor.formatOnSave": true；关闭"editor.formatOnType": false（避免干扰） - 关键一步：打开任意一个目标文件 →
Ctrl+Shift+P→ 输入Format Document With...→ 选你配好的 formatter（如Prettier）→ 回车。此时它会对**当前文件**执行完整格式化，包括缩进重写 - 要批量？全选资源管理器中所有目标文件（
Ctrl+Click多选），右键 →Reveal in Explorer不起作用；正确做法是：在终端中执行npx prettier --write "**/*.{js,ts,jsx}"（CLI 才是真正的批量）
绕不开的前置条件：editor.detectIndentation 必须关掉
哪怕你配好了 Prettier，如果 editor.detectIndentation 是 true（默认值），VSCode 在打开一个旧 .py 文件时仍会读首行缩进，临时把 insertSpaces 切成 false，导致 formatter 读到的“当前缩进偏好”仍是 Tab —— 最终格式化结果可能保留 \t。
- 必须在用户设置或工作区设置中显式设：
"editor.detectIndentation": false - 同时确保语言级设置不冲突：比如
[python]块里不能有"editor.insertSpaces": false - 验证是否生效：打开一个纯 Tab 缩进的老文件 → 看右下角是否显示
Tab Size: 4（说明 detectIndentation 还在生效）；应显示Spaces: 4才对
最常被忽略的细节：formatOnSave 不等于自动批量，它只对保存动作响应
你改完设置、装好插件、关掉 detectIndentation，然后兴冲冲去点保存——但发现只有当前文件变了。这是因为 formatOnSave 是被动触发，它不会主动遍历项目里所有文件并保存它们。
- 想真正“批量应用”，得人工触发保存：全选资源管理器中所有目标文件 → 右键 →
Reveal in Explorer无用；正确操作是按Ctrl+A选中全部文件 → 再按Ctrl+S（Windows/Linux）——VSCode 会依次保存每个文件，每保存一次就触发一次 formatOnSave - 但注意：若某文件语法错误（如 Python 缺括号），formatter 可能直接失败，缩进不会变。务必先保证代码可解析
- 更稳的方式永远是 CLI：
npx prettier --write "src/**/*.js"，它不依赖 VSCode 状态，也不怕 editor.detectIndentation 干扰
