VSCode 默认不自带 Python 格式化器，需安装 black/autopep8/yapf 并配置 "python.formatting.provider"；须确保格式化工具与 Python 解释器同环境，否则格式化失败且无明确提示。
VSCode 默认不自带 Python 格式化器，必须显式安装并配置第三方工具（如 black、autopep8 或 yapf），否则按 Shift+Alt+F 会提示“没有可用的格式化程序”或直接无响应。
确认已安装 Python 扩展和格式化工具
仅装 Microsoft 的 Python 扩展（ms-python.python）还不够——它只提供语言支持，不附带格式化逻辑。你得额外安装一个 CLI 工具，并确保 VSCode 能调用到它：
-
pip install black（推荐；严格遵循 PEP 8 且几乎无需配置） - 或
pip install autopep8（更宽容，支持部分自定义规则） - 或
pip install yapf（Google 风格为主，PEP 8 兼容性需调参） - 验证是否可用：
black --version或autopep8 --version在终端能正常输出
在 VSCode 中指定 Python 格式化程序
VSCode 不会自动猜用哪个工具。必须手动设置 python.formatting.provider，否则即使装了 black 也无效：
使用约定式提交（Conventional Commits）生成标准化的 Git 提交信息。适用于以下场景： (1) 暂存更改时需要提交信息； (2) 审查 diff 时希望获得结构化摘要； (3) 编写 PR 描述或变更日志（changelog）条目； (4) 用户明确要求“为本次更改编写提交信息”。 该功能会分析已暂存/未暂存的 diff，并生成按类型（type）划分范围的提交信息。
- 打开设置（
Ctrl+,），搜索python formatting provider - 选择值为
black（或autopep8/yapf） - 等效的
settings.json配置项是："python.formatting.provider": "black" - 如果使用虚拟环境，请确认该环境中已安装对应工具——VSCode 默认调用当前选中的 Python 解释器对应的
pip环境
格式化时忽略特定行或文件
black 默认不支持行级禁用（如 # fmt: off 是 23.10+ 版本才加的实验特性），而 autopep8 支持更成熟：
- 在某行末加
# noqa可跳过该行检查（但不阻止格式化） - 用
# autopep8: off和# autopep8: on包裹代码块可禁用格式化 - 全局忽略：在项目根目录加
.autopep8.cfg，写入exclude = migrations/,venv/ -
black的等效做法是用pyproject.toml配置exclude = ['migrations/']，但它不支持单行跳过
最容易被忽略的是解释器路径和格式化器路径的错位：VSCode 的 python.defaultInterpreterPath 设的是 /venv/bin/python，但 black 安装在系统级 /usr/local/bin/black，此时格式化会失败且无明确报错。务必让两者同环境，或在设置中显式指定 python.formatting.blackPath。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
