Python缩进报错主因是Tab与空格混用，须禁用VSCode的editor.detectIndentation并为Python语言专属配置insertSpaces:true、tabSize:4；已有Tab需用“Convert Indentation to Spaces”安全转换，而非全局替换。
Python 缩进报错（IndentationError）几乎全是 Tab 和空格混用导致的，不是代码逻辑问题，而是编辑器没管住缩进字符类型——必须关掉 editor.detectIndentation，并强制所有 Python 文件用空格。
为什么改了设置还是报 IndentationError？
因为 VSCode 默认开启 editor.detectIndentation，它会读取文件第一行缩进风格，自动切换成 Tab 或空格模式。你设了 "editor.insertSpaces": true，但打开一个首行是 \t 的旧文件，VSCode 就立刻覆盖你的设置，按 Tab 还是插制表符。
- 右下角状态栏显示
Tab Size: 4后跟着Tab（不是Spaces），说明当前文件已被“猜”成 Tab 模式 -
black或autopep8格式化工具不会修复语法错误，只重排合法代码；如果已有缩进错乱（比如if块里某行少缩进一个空格），它们直接拒绝运行 - Python 解释器在运行时才校验缩进一致性，编辑器不报错 ≠ 代码没问题
怎么让 Python 文件永远用 4 个空格？
不能只靠全局设置，语言专属配置优先级更高，且必须禁用自动检测。
- 打开命令面板（
Ctrl+Shift+P），输入Preferences: Configure Language Specific Settings，选中python - 添加以下配置（确保覆盖所有可能冲突的来源）：
{ "[python]": { "editor.insertSpaces": true, "editor.tabSize": 4, "editor.detectIndentation": false } } - 检查项目根目录是否有
.vscode/settings.json，里面不能有"editor.insertSpaces": false这类反向配置 - 确认右下角语言标识是
Python（不是Plain Text或Shell Script），否则语言专属设置不生效
已有文件里的 Tab 怎么安全转成空格？
别用 Ctrl+H 搜 ^\t 替换——它会误伤字符串、注释、YAML 键名里的 \t，且不识别嵌套层级，容易让 if 块和 else 错位。
立即学习“Python免费学习笔记（深入）”；
- 打开目标文件，点击右下角
Tab Size: 4（或Spaces: 4），直到菜单里出现Convert Indentation to Spaces并可点击 - 执行后，VSCode 会按当前
tabSize值，逐行重算缩进层级，只替换被识别为“缩进”的\t，保留字符串内、注释中的制表符 - 若菜单项灰色，说明当前已是空格模式（显示
Spaces: 4），无需转换 - 批量处理多个文件？没有一键按钮。先用
Ctrl+Shift+F全局搜^\t（正则开启）确认哪些文件含缩进 Tab，再逐个打开执行转换
为什么 Convert Indentation to Spaces 执行后还报错？
这个命令只解决“字符类型”，不修复“缩进逻辑”。比如函数体首行缩进 4 空格，但内部某 print() 行缩进只有 2 空格，它不会帮你补那 2 个空格——那是你代码写错了，不是缩进风格问题。
- 启用空白符可视化：
Ctrl+Shift+P→Toggle Render Whitespace，看每行开头是→（Tab）还是·（空格） - 混合缩进（如
→ ··开头）会被归一化为全空格，但原有对齐可能失效，需人工核对if/for/def块是否仍严格对齐 - Git diff 显示大量缩进变更？说明之前提交过 Tab 缩进的代码，这次转换后所有行都变，建议在干净分支上操作，避免污染历史
