如何配置虚拟环境让VS Code用autopep8/Black/Ruff格式化Python文件

排查虚拟环境与工作区层级 #

• 确保项目代码文件夹和虚拟环境文件夹为同级关系，比如虚拟环境是venv/，项目代码是my_django_project/，二者在同一父目录下，不要把项目放在虚拟环境文件夹内部。
• 打开VS Code时直接选择项目代码文件夹作为工作区，不要打开包含虚拟环境和项目的父文件夹，避免扩展误识别文件归属。

调整格式化扩展的规则配置 #

打开VS Code设置（快捷键Ctrl+,），针对每个格式化扩展调整排除/包含规则：

• Black Formatter：搜索Black > Exclude，确保仅排除虚拟环境、.git等无关文件夹（如**/venv/**/*）；搜索Black > Include，添加项目文件路径规则，比如**/my_django_project/**/*.py。
• autopep8：搜索Autopep8 > Exclude，移除包含项目路径的规则，或添加!**/my_django_project/**/*.py抵消排除规则对项目文件的影响。
• Ruff：搜索Ruff > Lint > Exclude，仅保留虚拟环境等无关路径的排除规则，确保项目文件不被排除。

也可直接在settings.json中手动配置，示例：

{
  "python.formatting.provider": "black",
  "black.exclude": ["**/venv/**/*", "**/.git/**/*"],
  "black.include": "**/my_django_project/**/*.py"
}

重置工作区与解释器关联 #

• 关闭VS Code，删除项目文件夹下的.vscode/文件夹（清除本地工作区配置），重新打开项目文件夹。
• 确认状态栏显示的Python解释器为项目对应的虚拟环境版本（如./venv/bin/python或.\venv\Scripts\python.exe）。
• 针对每个格式化扩展，设置其使用虚拟环境中的工具版本：比如搜索Black > Path，指定为虚拟环境内的black路径（./venv/bin/black）。

修正文件的标准库标记 #

• 打开无法格式化的.py文件，按下Ctrl+Shift+P打开命令面板，输入Python: Inspect Editor Variables，查看isStandardLibrary的值。若为true，说明VS Code误判了文件归属。
• 在settings.json中添加以下配置，让分析器正确识别项目文件：

"python.analysis.exclude": ["**/venv/**/*"]

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