在VSCode中正确配置和使用Python虚拟环境

VSCode中正确配置Python虚拟环境需三步：一是在项目根目录运行python -m venv .venv创建环境；二是通过命令面板选择对应解释器路径并确认状态栏显示；三是配置终端自动激活，验证sys.executable路径含.venv且pip list仅显示基础包。

在 VSCode 中正确配置 Python 虚拟环境，关键不是“创建完就完事”，而是让编辑器真正识别、激活并持续使用它——包括解释器选择、终端自动激活、以及避免常见路径和权限陷阱。

创建虚拟环境要指定明确路径

不要依赖默认位置（比如项目根目录下无名的 venv），容易混淆或被误删。推荐统一放在项目内的 .venv 文件夹：

• 终端中运行：python -m venv .venv（Windows/macOS/Linux 均适用）
• 确保当前目录是你的项目根目录，.venv 会自动创建且被 VSCode 默认忽略（因以点开头）
• 如果提示“找不到 python 命令”，说明系统没配好 Python 路径，先运行 where python（Win）或 which python3（macOS/Linux）确认可执行文件位置

手动指定 VSCode 使用的 Python 解释器

VSCode 不会自动切换到你刚建的虚拟环境，必须手动选一次，之后才生效：

• 快捷键 Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（macOS），输入 Python: Select Interpreter
• 在列表中找到类似 ./.venv/bin/python（macOS/Linux）或 .\.venv\Scripts\python.exe（Windows）的路径并选择
• 状态栏左下角会显示当前解释器路径，确认它指向 .venv 内部
• 选完后，VSCode 会自动在工作区生成 .vscode/settings.json，写入 "python.defaultInterpreterPath"，这是项目级配置，团队协作时建议提交该文件

让集成终端自动激活虚拟环境

否则每次打开新终端都要手动运行 source .venv/bin/activate（macOS/Linux）或 .venv\Scripts\activate（Windows），很麻烦：

Anakin

一站式 AI 应用聚合平台，无代码的AI应用程序构建器

317

查看详情

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

• 打开设置（Ctrl+,），搜索 Python: Terminal Execute In File Dir，勾选它
• 再搜索 Python: Default Interpreter Path，确认值与上面选的一致
• 更关键的是：在用户或工作区设置中添加：
  "python.terminal.launchArgs": ["-WorkingDirectory", "${workspaceFolder}"]（仅 Windows PowerShell 用户需额外配置）
• 重启终端（Ctrl+Shift+` 关闭再打开），应该看到提示符前带 (.venv)，表示已激活

验证是否真正生效

别只看状态栏，实际测一下最可靠：

• 新建一个 test.py，写 import sys; print(sys.executable)，运行它——输出路径应包含 .venv
• 在集成终端中运行 pip list，只看到基础包（如 pip、setuptools），没有全局安装的第三方库
• 用 pip install requests 安装一个包，再在 Python 文件中 import requests，不报错即成功
• 如果仍提示 ModuleNotFoundError，大概率是解释器没选对，或终端没激活，回头检查前两步

基本上就这些。不复杂但容易忽略细节——尤其是解释器选择和终端激活这两步，缺一不可。

以上就是在VSCode中正确配置和使用Python虚拟环境的详细内容，更多请关注php中文网其它相关文章！