Black在VSCode中不会自动生效，必须同时满足：选对Python解释器（路径需与black安装环境一致）、settings.json中配置"editor.formatOnSave": true、"[python]": {"format.enable": true}和"python.formatting.provider": "black"、项目根目录存在含[tool.black]段的pyproject.toml，且修改后需重启窗口。
Black 在 VSCode 里不会自动生效，哪怕你 pip install black 成功了——必须手动打通解释器、格式化器和配置文件三者的链路，缺一不可。
Python 解释器没选对，Black 就根本启动不了
VSCode 不会跨环境找 black，它只在你当前选中的 python.defaultInterpreter 对应的环境中执行 python -m black。终端里能跑 black --version，不代表 VSCode 能用。
- 按
Ctrl+Shift+P（Mac 为Cmd+Shift+P），运行Python: Select Interpreter，路径必须指向你装了black的环境（比如./venv/bin/python或~/miniconda3/envs/myproj/bin/python） - 在 VSCode 集成终端中运行
python -m black --version，有输出才算真正可用；若报ModuleNotFoundError: No module named 'black'，就立刻在这个环境下重装：pip install black - 用 conda 的话，别只在
base环境装black，必须先conda activate myenv再pip install black - 别信
which black的结果：VSCode 启动时读的是解释器环境的PATH，不是你 shell 的
settings.json 里这三行必须同时存在
editor.formatOnSave 开了，python.formatting.provider 没设，或者 [python] 块漏掉，都会导致保存时静默失败。
- 在
settings.json中加这三行（注意方括号和引号不能少）： "editor.formatOnSave": true"[python]": { "format.enable": true }"python.formatting.provider": "black"- 删掉
python.formatting.blackArgs这类冗余配置——除非你真要传额外参数（如--preview），否则它大概率被忽略，还容易拼错成python.formatting.blackargs（小写 a）导致静默失效 -
editor.formatOnType建议保持false：Black 不支持实时格式化，开它反而卡顿或触发错误
pyproject.toml 放错位置或格式不对，VSCode 就当它不存在
VSCode 的 Python 扩展只识别项目根目录下的 pyproject.toml，且必须包含合法的 [tool.black] 段。写成 black.toml、.black、或放在 src/ 里，它直接无视。
python-script-generator
下载
快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构，支持CLI、API、爬虫、Bot、Django等多种项目类型，包含完整的项目结构、配置文件、依赖管理、测试、README和文档。
立即学习“Python免费学习笔记（深入）”；
- 文件名只能是
pyproject.toml，不能是setup.cfg或tox.ini（Black 22.3.0+ 已弃用这些） - 必须放在工作区根目录（即 VSCode 左上角显示的文件夹路径），不是
src/或app/子目录 - 最小可用配置示例（存为项目根目录下的
pyproject.toml）：
[tool.black] line-length = 88 skip-string-normalization = true include = '\.pyi?$' exclude = ''' /( \.git | __pycache__ | venv )/ '''
Ctrl+Shift+P → Developer: Reload Window，否则缓存会让新规则不生效格式化失败报 “command 'python.execInTerminal' not found”？其实是 Black 路径没被识别
这个错误不是 black 本身的问题，而是 VSCode 找不到可执行的 black 命令。尤其在使用 pyenv、conda 或虚拟环境时，VSCode 启动的终端环境和你在命令行里用的不是同一个上下文，PATH 里没有 black。
- 确认
black是否在解释器环境的bin/（或Scripts/）目录下：比如./venv/bin/black或./venv/Scripts/black.exe - 如果路径存在但 VSCode 仍报错，尝试在
settings.json中显式指定python.formatting.blackPath（不推荐，仅临时绕过）： -
"python.formatting.blackPath": "./venv/bin/black"（macOS/Linux） -
"python.formatting.blackPath": "./venv/Scripts/black.exe"（Windows） - 更稳妥的做法是：确保解释器选对 +
pip install black在该环境下执行 + 重启窗口
最容易被忽略的是：VSCode 的 Python 扩展只在启动时加载一次 pyproject.toml，改了配置不重载窗口，旧行为照常；还有就是 [python] 配置块里漏掉方括号或引号，整段设置就失效——这种错误不报错，只安静地不工作。
