You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

VS Code无法正常激活Python venv虚拟环境问题求助

问题描述

在Ubuntu 24.04.2(Python 3.13.5)和Ubuntu 22.04.5(Python 3.12.7)系统上使用VS Code 1.102.0时,遇到虚拟环境激活异常:

  • VS Code底部栏与命令提示符显示.venv已激活,但执行pip list列出的是系统Python模块,运行deactivate提示command not found
  • 手动执行source .venv/bin/activate后,提示符变为怪异的(.venv) .venv,此时虚拟环境才真正生效
  • 此前重启VS Code可解决同类问题,但当前版本失效
解决方案

1. 重置VS Code Python解释器配置

  • 打开VS Code设置(快捷键Ctrl+,),搜索Python: Venv Path,确认路径指向项目根目录下的.venv文件夹
  • 搜索Python: Default Interpreter Path,手动选择.venv/bin/python作为默认解释器
  • 保存设置后,关闭并重新打开项目窗口

2. 强制终端优先使用虚拟环境路径

  • 打开VS Code设置,搜索Terminal > Integrated > Env > Linux,添加以下配置:
    "terminal.integrated.env.linux": {
        "VIRTUAL_ENV": "${workspaceFolder}/.venv",
        "PATH": "${workspaceFolder}/.venv/bin:${env:PATH}"
    }
    
  • 该配置会让终端优先加载虚拟环境内的可执行文件,避免系统Python干扰

3. 排查shell配置的重复激活问题

  • 打开终端执行echo $PROMPT_COMMAND,检查是否存在重复调用.venv/bin/activate的配置
  • 若发现重复,编辑~/.bashrc或~/.zshrc(根据你使用的shell),移除多余的激活命令
  • 执行source ~/.bashrc(或对应shell的配置文件)使修改生效

4. 重新创建虚拟环境

  • 删除现有.venv文件夹:rm -rf .venv
  • 使用对应Python版本重新创建虚拟环境:
    python3.13 -m venv .venv  # Ubuntu 24.04.2系统
    # 或
    python3.12 -m venv .venv  # Ubuntu 22.04.5系统
    
  • 重新激活环境并安装依赖,再用VS Code打开项目测试

5. 排查扩展冲突

  • 暂时禁用所有非官方Python相关扩展,仅保留官方Python扩展,重启VS Code测试问题是否消失
  • 若问题解决,逐个重新启用扩展,定位出干扰虚拟环境激活的扩展并禁用

内容的提问来源于stack exchange,提问作者Paul Jurczak

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.06.12 16:44:53