VSCode中配置Python虚拟环境的正确方法

在vscode中正确配置python虚拟环境的关键是让编辑器识别并使用项目内创建的venv，而非全局Python；需安装官方Python扩展、在项目目录运行python -m venv .venv、通过命令面板选择对应解释器路径，并验证sys.executable指向.venv内python。

在 VSCode 中正确配置 Python 虚拟环境，核心是让编辑器识别并使用你创建的虚拟环境，而不是系统全局 Python。关键不在于“怎么装插件”，而在于“VSCode 怎么找到并激活它”。

确认已安装 Python 扩展和基础工具

确保已安装官方 Python 扩展（microsoft 出品），它提供解释器选择、调试、代码补全等核心支持。不需要额外装“Python Environment Manager”之类第三方插件。同时确认本地已安装 python3 和 venv（Python 3.3+ 自带，无需 pip install）。

在项目目录中创建虚拟环境

不要在用户根目录或随意位置建 venv。打开 VSCode 的集成终端（Ctrl+`），确保当前路径是你的项目文件夹（如 ./my_project），然后运行：

• windows：python -m venv .venv
• macOS / linux：python3 -m venv .venv

推荐用 .venv 作为文件夹名（带点开头，VSCode 默认忽略，且被多数 Python 工具识别）。创建后不要手动激活 shell —— VSCode 不依赖 shell 激活状态。

立即学习“Python免费学习笔记（深入）”；

TabTab AI

首个全链路 Data Agent，让数据搜集、处理到深度分析一步到位。

292

查看详情

在 VSCode 中选择该虚拟环境作为解释器

按 Ctrl+Shift+P（或 Cmd+Shift+P），输入并选择 Python: select Interpreter。在弹出列表中，找到类似这样的路径：

• windows：./.venv/Scripts/python.exe
• macOS：./.venv/bin/python
• Linux：./.venv/bin/python

选中后，VSCode 底部状态栏会显示解释器路径，且自动启用该环境下的包补全、linting 和调试。此时 settings.json 里会自动生成一行："python.defaultInterpreterPath": "./.venv/bin/python"（路径依系统而异）。

验证是否生效

新建一个 test.py，写入 import sys; print(sys.executable)，运行它。输出路径应指向你刚选的 .venv 内的 python 可执行文件。再用 pip list 查看，只应看到基础包（pip, setuptools），没有你全局装的包 —— 这说明隔离成功。

基本上就这些。不用改系统 PATH，不用手动 source，也不用每次打开都重选——只要项目目录下有 .venv 且解释器已正确配置，VSCode 就会记住并默认使用它。