Shift + Alt + F 是最稳妥的默认快捷键，但需确保已安装 autopep8 或 black 并在 settings.json 中配置 python.formatting.provider，且文件语言模式为 Python，否则无效。
直接结论：Shift + Alt + F 是最稳妥的默认快捷键，但必须确认背后用的是 autopep8 或 black，否则按了也白按。
为什么按 Shift + Alt + F 没反应？
VSCode 默认不自带 Python 格式化器，只提供“格式化文档”这个动作入口，具体执行谁、怎么执行，全看配置。常见现象包括：
- 按完无任何变化，状态栏也不提示
- 弹出错误：“No formatter installed for 'python'”
- 代码缩进被改了，但空格/换行/括号风格依然不符合 PEP 8
根本原因是你没装格式化工具，或者装了但没告诉 VSCode 该用谁。必须同时满足两个条件：
- 本地已安装
autopep8（pip install autopep8）或black（pip install black） - VSCode 设置中明确指定
python.formatting.provider为"autopep8"或"black" - 确保当前文件语言模式是
python（右下角显示 “Python”，不是 “Plain Text”）
如何让 Shift + Alt + F 真正符合 PEP 8？
关键不是改快捷键，而是绑定对的格式化器。以 autopep8 为例（它比 black 更贴近 PEP 8 原文）：
立即学习“Python免费学习笔记（深入）”；
- 在
settings.json中添加：{"python.formatting.provider": "autopep8", "python.formatting.autopep8Args": ["--max-line-length=88", "--aggressive"]} -
--max-line-length=88是 PEP 8 推荐值（非强制的 79），比默认 79 更实用 -
--aggressive能修复更多风格问题（比如多余空格、括号换行），但会改变原始逻辑布局，慎用于已有项目 - 如果团队用
black，则设"python.formatting.provider": "black"，它不支持自定义行宽，固定为 88
自动保存时格式化，但不想每次改一行都触发
editor.formatOnSave 开启后，保存即格式化，但容易和 lint 工具冲突（比如 flake8 报 E201/E202 时，autopep8 可能反复加删空格）。建议：
- 仅对 Python 文件启用：
{"[python]": {"editor.formatOnSave": true}} - 关闭
editor.formatOnType（实时格式化易打断思路） - 若同时启用了
python.linting.flake8Enabled，在python.linting.flake8Args中加--ignore=E201,E202,E231，避免格式化器和 linter 对同一处反复争执 - 注意：某些旧版插件（如早期
ms-python.python）会把autopep8当作“辅助修复”，而非主格式化器，此时需手动在命令面板里运行Python: Select Formatter并选中autopep8
快捷键冲突或想换键位怎么办？
VSCode 允许重绑 editor.action.formatDocument，但要注意：
- 别用
Ctrl + S这类系统级快捷键，会覆盖保存操作 - 推荐组合：例如
Ctrl + Shift + F（避开 Windows 默认的“查找”）或Alt + F（需配合其他修饰键才不冲突） - 修改方式：打开命令面板（
Ctrl + Shift + P），搜Preferences: Open Keyboard Shortcuts，输入formatDocument，右键对应项 →Change Keybinding - 切记：改完快捷键 ≠ 改完格式化逻辑，仍要检查
python.formatting.provider是否生效
真正卡住人的从来不是快捷键记不住，而是按下去之后，VSCode 不知道该叫谁来干活——工具链没对齐，再顺手的键也是摆设。
