VSCode里如何配置Python虚拟环境？【教程】

VSCode通过Python扩展识别虚拟环境，需手动指定解释器路径；自动扫描仅限项目根目录下的.venv、venv、env等标准命名目录，且要求结构完整；conda环境必须手动输入绝对路径；验证需运行sys.executable和pip测试。 VSCode 本身不管理 Python 虚拟环境 ，它只负责识别和使用你已创建好的环境。关键不是“配置”，而是让 VSCode 正确找到 可执行文件的路径。 如何让 VSCode 找到你的虚拟环境？ VSCode 通过 Python 扩展读取工作区或用户级设置中的 ，或者自动扫描常见目录（如 、 、 ）。但自动发现经常失败，尤其在多项目混用或自定义路径时。 推荐做法：打开项目根目录后，按 （Windows/Linux）或 （ mac OS），输入并选择 如果列表里没出现你的环境，点击 ，然后手动定位到虚拟环境里的 （Windows 是 ，macOS/Linux 是 ） 选中后，VSCode 会在当前工作区生成 ，写入类似： 为什么 创建的环境有时不被识别？ VSCode 的 Python 扩展默认只扫描项目根目录下的特定名称子目录（ 、 、 ），且要求该目录下存在 和有效的 或 子目录。常见失效原因： 你在项目外运行了 ，导致 目录不在当前 VSCode 工作区根目录下 你用了非标准路径，比如 ，VSCode 不会跨目录查找 你在 WSL 中创建了环境，但 VSCode 运行在 Windows 端，无法直接访问 WSL 路径（需用 前缀或在 WSL 中启动 VSCode） 使用 环境时要注意什么？ Conda 环境路径不遵循 venv 结构，VSCode 无法自动发现，必须手动指定解释器路径。 Trae win Trae Windows 官方版本现已全面支持 Win10 和 Win11 系统（64位）。国内开发者可直接访问 Trae 中文官网（trae.cn 或 trae.com.cn），一键下载官方正版 .exe 安装包，享受国内直连的高速稳定体验。安装过程极其简便，双击即可运行，并支持一键无缝导入 VS Code 或 Cursor 的原有主题、快捷键及插件配置。登录支持手机号、微信或稀土掘金账号。内置免费的豆包与 DeepSeek 等顶级大模型，让你开箱即用，轻松开启高效的 AI 智能编程之旅。 下载 立即学习 “ Python免费学习笔记（深入） ”； 先在终端激活 conda 环境： 再运行 （macOS/Linux）或 （Windows）获取绝对路径 在 VSCode 中通过 → 粘贴该路径 注意：不要选 conda 自带的 base 环境的 ，除非你明确想用它；conda 环境路径通常形如 或 检查是否真的生效了？ 光看右下角状态栏显示的 Python 版本还不够。真正验证方式是： 新建一个 文件，输入 ，运行它 —— 输出的 必须和你在 中选的一致 安装包后（如 ），确保在 VSCode 的集成终端中运行 不报错；如果报 ，说明终端没继承当前解释器环境（可能终端未重启，或 VSCode 启动时没加载 shell 配置） 调试时断点不触发、 报 ，大概率是 路径没对齐 最常被忽略的是：VSCode 集成终端默认不会自动激活你选中的解释器对应的环境，它只是复用系统 shell。你需要手动在终端里运行 （或对应平台的激活命令），或者在 中配置 来预设 环境变量 ——但这属于进阶控制，多数人只需记住「选解释器 ≠ 终端自动激活」。