需配置Black为默认格式化程序、确认black路径正确、在项目虚拟环境中安装Black，并禁用autopep8等冲突扩展，才能使VSCode保存时自动格式化Python代码。
如果您在VSCode中安装了Black Formatter扩展，但Python代码保存时未自动格式化，则可能是由于格式化程序未正确配置或未设为默认。以下是解决此问题的步骤：
本文运行环境：MacBook Air，macOS Sequoia。
一、检查并设置Black为默认Python格式化程序
VSCode需明确指定Black作为Python语言的默认格式化工具，否则即使已安装Black和扩展，也不会触发格式化行为。
1、打开VSCode命令面板（快捷键：Cmd+Shift+P）。
立即学习“Python免费学习笔记（深入）”；
2、输入并选择“Preferences: Open Settings (JSON)”。
3、在settings.json文件中添加或确认以下配置项：
"python.defaultInterpreterPath": "/usr/local/bin/python3",
"python.formatting.provider": "black",
"editor.formatOnSave": true,
"[python]": { "editor.formatOnSave": true }。
二、验证Black可执行文件路径是否正确
VSCode需要能定位到系统中实际可用的black命令，若路径错误或black未全局安装，格式化将静默失败。
1、在终端中执行which black，确认输出类似/opt/homebrew/bin/black的路径。
2、回到VSCode设置JSON，添加或修改配置项：
"python.formatting.blackPath": "/opt/homebrew/bin/black"。
3、重启VSCode使路径变更生效。
三、通过Python环境内安装Black并绑定虚拟环境
当项目使用虚拟环境时，VSCode可能无法识别全局black，必须在当前Python解释器环境中安装Black。
1、在VSCode中按Cmd+Shift+P，执行“Python: Select Interpreter”。
2、选择项目所用的venv路径（如./venv/bin/python）。
3、在集成终端中运行：pip install black。
4、确保settings.json中"python.defaultInterpreterPath"指向该venv下的python可执行文件。
四、禁用冲突的格式化扩展
其他Python格式化扩展（如autopep8、yapf）可能抢占格式化权限，导致Black不响应。
1、点击左侧扩展图标（或Cmd+Shift+X），在搜索框输入“autopep8”。
2、对已启用的autopep8、yapf等扩展，点击其右下角齿轮图标，选择“Disable Workspace”。
3、重新保存一个.py文件，观察是否触发Black格式化。
