Windows系统VS Code中Black运行但不格式化Python代码如何解决

核心原因 #

--diff 参数的作用是仅输出格式化前后的差异对比，不会直接修改源文件，VS Code 官方默认调用 Black 时不会携带该参数，该问题通常是配置中额外添加了错误的 Black 运行参数，或是缺少保存自动格式化的必要开关导致。

修复步骤 #

1. 更新项目配置 #

修改你的 .vscode/settings.json 文件，补充必要配置、删除错误的 --diff 参数：

{
    // 开启保存时自动格式化
    "editor.formatOnSave": true,
    // 仅指定Python文件使用Python扩展作为格式化工具，避免影响其他类型文件
    "[python]": {
        "editor.defaultFormatter": "ms-python.python"
    },
    "python.pythonPath": "C:\\Users\\me\\Anaconda3\\python.exe",
    "python.formatting.provider": "black",
    // 清空Black额外参数，禁止添加--diff参数，可根据需求添加--line-length等合法参数
    "python.formatting.blackArgs": []
}

注意：如果你的 VS Code 全局设置中也配置了 python.formatting.blackArgs，需要同步检查并删除其中的 --diff 参数。

2. 验证修复效果 #

配置修改完成后重启 VS Code，打开一个存在格式问题的 Python 文件，按下 Ctrl+S 保存，即可看到文件内容被自动格式化。

异常排查 #

如果修改配置后仍未生效，可按以下步骤排查：

• 确认当前使用的 Python 环境已正确安装 Black：打开终端激活对应 Anaconda 环境，执行 pip install black --upgrade 安装/升级到最新版 Black
• 不要同时启用 autopep8、yapf 等其他 Python 格式化工具，避免出现配置冲突
• 升级 Python 扩展（ms-python.python）到最新版本，排除旧版本扩展的兼容性 bug

内容的提问来源于stack exchange，提问作者atm