python缩进必须用4空格且禁用tab，否则报indentationerror；语言id需为python（非plain text或python (jinja)）才能生效；settings.json中缩进配置须置于"[python]"块内并关闭detectindentation；历史混用缩进需手动转换为空格；字典/参数对齐需black等格式化器，非编辑器缩进设置。
VSCode 中 Python 代码缩进必须用 4 个空格、禁用 Tab，否则运行时会直接报 IndentationError；对齐（如字典键值、函数参数竖排）不是缩进问题，得靠 black 或 autopep8 这类格式化器，编辑器本身不提供“自动对齐”能力。
为什么 Python 文件缩进总出错？语言 ID 没认对
VSCode 不看文件后缀 .py 就启用 Python 缩进规则，它只认右下角状态栏显示的 language ID。如果那里写着 Plain Text 或 Python (Jinja)，所有 [python] 配置都无效。
- 点击右下角语言名 → 确认弹出菜单顶部显示的是
python（全小写，无括号、无空格） - 如果不是，从菜单里手动选
Python；之后 VSCode 才加载[python]块里的设置 - 未保存的空白文件默认是
Plain Text，必须先保存为.py再手动切语言 ID
settings.json 怎么配才真正生效？别写错位置
全局配置会干扰 Python，必须把缩进规则锁死在 [python] 块内，并关闭自动检测。写错位置等于白配。
- 打开
settings.json（设置界面右上角 {} 图标） - 追加以下内容，**不要删掉已有配置**，只修改或新增
[python]块：
{
"[python]": {
"editor.insertSpaces": true,
"editor.tabSize": 4,
"editor.detectIndentation": false,
"editor.autoIndent": "full"
}
}
"editor.tabSize" 或 "editor.insertSpaces" 的全局设置（比如在顶层写的），否则会被覆盖"editor.detectIndentation": false 是关键：防止 VSCode 根据文件开头几行误判缩进风格老文件缩进混乱（混用 Tab 和空格）怎么办？配置不修复历史
上面的配置只影响新输入和格式化行为，不会自动清理已有混用缩进。VSCode 不会“修正”历史，必须手动归一化。
- 全选代码（
Ctrl+A）→Ctrl+Shift+P→ 输入Convert Indentation to Spaces→ 选4 Spaces - 按
Ctrl+Shift+P→ 输入Toggle Render Whitespace，打开空白符显示，一眼看出哪些行是\t、哪些是空格 - 粘贴进来的代码缩进错乱？先执行
Convert Indentation to Spaces，再用Tab/Shift+Tab微调 - 如果文件里有非标准缩进（比如首行 3 个空格），
detectIndentation开着时Tab行为会不可预测，所以必须关掉
想让字典/函数参数自动对齐？这不是缩进，是格式化
VSCode 默认缩进（Tab）只控制行首空白，不会把 name='Alice' 和 age=30 对齐成竖列——那是格式化器的事，比如 black 或 autopep8。
- 安装 Python 扩展（Microsoft 官方）和格式化器（如
black：pip install black） - 在
settings.json中设默认格式化器："python.formatting.provider": "black" - 开启保存自动格式化：
"editor.formatOnSave": true（确保它在顶层，不是嵌套在[python]里） - 手动触发对齐：
Ctrl+Shift+I（格式化选区）或Shift+Alt+F（格式化整个文件） - 注意：
black的对齐逻辑由其自身规则决定，不响应editor.tabSize；若要兼容团队tabWidth: 4，需在pyproject.toml里配[tool.black] line-length = 88等，而非编辑器设置
最常被忽略的是：语言 ID 错了，后面所有配置都是摆设；老文件混用缩进，配置再对也救不回来；对齐需求强行塞给缩进设置，结果等半天没反应——那是因为你该装 black，而不是调 tabSize。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
