IndentationError在运行时才报错，因Python将缩进视为语法规则而非语法糖，VSCode默认不校验缩进合法性；需配置editor.insertSpaces:true、tabSize:4并禁用detectIndentation，配合Black和pre-commit确保团队一致。
为什么IndentationError总在运行时才报错，而不是编辑时就提醒？
Python 依赖缩进来定义代码块，不是语法糖而是语法规则。VSCode 默认只做基础高亮，不主动校验缩进合法性，所以IndentationError往往到python解释器执行时才暴露——比如混合用了 Tab 和空格、某行多缩进两个空格但没报错、函数体首行缩进对齐了但内部某行少了一个空格。
关键不是“有没有缩进”，而是“缩进是否一致且符合 PEP 8”。VSCode 可以提前拦截，但需要明确告诉它：用空格、每级 4 个、保存时自动修正。
- 检查当前文件右下角状态栏：显示的是
Tab Size: 4还是Spaces: 4？如果是Tab，点击它并选Convert Indentation to Spaces - 确保工作区设置了
"editor.insertSpaces": true和"editor.tabSize": 4，否则单个文件改了，新开的 Python 文件还会默认用 Tab - 禁用可能冲突的格式化插件（如某些旧版 Python 扩展自带的 autopep8 格式化），优先用 Prettier + Python 插件组合或直接启用
black
VSCode 中如何让 Ctrl+S 自动把 Tab 转成 4 个空格？
这不是靠“格式化”触发的，而是编辑器的“插入行为”控制。即使你没装任何 Python 格式化工具，只要配置对，新建/粘贴/回车缩进都会自动用空格。
在 .vscode/settings.json（工作区级）或用户设置中加入：
{
"editor.insertSpaces": true,
"editor.tabSize": 4,
"editor.detectIndentation": false,
"[python]": {
"editor.insertSpaces": true,
"editor.tabSize": 4
}
}
"editor.detectIndentation": false 很关键：它阻止 VSCode 每次打开文件时“猜测”缩进风格，避免从 Git 拉下来的混合缩进文件被误判成 Tab 风格，然后你一敲 Tab 就又混进去了。
用 black 格式化后还是报 IndentationError？检查这三处
black 是强约束格式化工具，但它不修复语法错误，只按规则重排合法代码。如果原始代码已有缩进逻辑错乱（比如 if 块里某行缩进比 if 少、或 return 和 print 缩进不一致），black 会拒绝处理并报错。
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
- 运行
black --check your_file.py看是否提示error: cannot format ...—— 这说明存在语法级缩进矛盾，得人工先修好再格式化 - 确认
black版本 ≥23.10.0：老版本对嵌套推导式、类型注解中的缩进处理不一致，容易误判 - VSCode 的 Python 扩展设置里是否启用了
"python.formatting.provider": "black"？如果同时开了autopep8或yapf，它们可能抢在black前改出非法缩进
团队协作时，怎么防止有人提交 Tab 缩进的 Python 文件？
光靠本地设置不够。Git 提交前卡住才是硬保障。
在项目根目录加 .editorconfig：
[*] indent_style = space indent_size = 4 [*.py] indent_style = space indent_size = 4
再配一个 pre-commit 钩子（推荐用 pre-commit 工具 + pyproject.toml）：
[tool.black]
line-length = 88
skip-string-normalization = true
[tool.pre-commit-config]
repos = [
{
repo = "https://github.com/psf/black",
rev = "24.4.2",
hooks = [{id = "black"}],
},
]
这样每次 git commit 时，black 会强制重写缩进，失败则中断提交。比靠人看 PR 更可靠。
真正难防的不是 Tab，是“看着像空格但其实是全角空格、零宽空格、或者 IDE 自动补的不可见字符”。遇到诡异缩进错误，用 VSCode 的 Ctrl+Shift+P → Toggle Render Whitespace 显形查看。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
