在VS Code中配置完美的Python虚拟环境与解释器

在 vs code 中配置 python 虚拟环境需按顺序操作：先用命令行创建 .venv 环境，再通过命令面板手动选择对应解释器路径，最后通过状态栏、sys.executable 和 pip list 验证生效。

在 VS Code 中配置 Python 虚拟环境和解释器，关键不是“一步到位”，而是理清顺序、避免路径混乱、让 VS Code 真正识别并使用你创建的环境。下面这些步骤，实测有效，不绕弯。

先用命令行创建干净的虚拟环境

别依赖插件自动创建，容易出路径问题。打开终端（系统自带或 VS Code 内置 Terminal），进入你的项目文件夹，执行：

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

注意：用 .venv（点开头）是约定俗成的隐藏文件夹名，VS Code 默认识别它为虚拟环境；不要用 venv 或其他名字，否则可能不自动提示。

在 VS Code 中手动指定解释器路径

按 Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（mac），输入 Python: select Interpreter，回车。

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

然后从列表里找带 .venv 字样的路径，例如：

TabTab AI

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

279

查看详情

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

如果没出现，选 Enter interpreter path…，手动导航到 .venv 文件夹下的对应 python 可执行文件。

确认环境已生效的三个信号

选完解释器后，别急着写代码，先验证是否真生效：

• 右下角状态栏显示当前解释器路径（含 .venv）
• 新建 .py 文件，输入 import sys; print(sys.executable)，运行后输出路径应指向 .venv 里的 python
• 在终端中运行 pip list，只看到基础包（pip、setuptools），说明是干净的虚拟环境，不是全局 Python

装包和调试都走这个环境

VS Code 的 Python 扩展会自动把 pip install 命令发给当前选中的解释器，所以：

• 在集成终端里直接 pip install requests，包就装进 .venv
• 调试（F5）时，launch.json 不用额外配 pythonPath（新版已弃用），只要解释器选对，调试器自然用它
• 如果用了 requirements.txt，在激活了该环境的终端里运行 pip install -r requirements.txt

不需要手动激活 source .venv/bin/activate —— VS Code 已为你隔离好环境。

基本上就这些。不复杂但容易忽略细节：用 .venv 文件夹名、手动选解释器路径、用 sys.executable 验证。做完这三步，你的 Python 开发环境就稳了。