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

Windows系统Jupyter环境配置及VS Code虚拟环境适配问题

解决VS Code中Jupyter笔记本与Python虚拟环境不匹配的问题

先明确:你的激活命令是对的

在Windows PowerShell环境下,用.venv/Scripts/Activate.ps1激活虚拟环境是正确操作,没问题。

解决Jupyter环境不匹配的步骤

  • 第一步:给虚拟环境安装Jupyter内核
    先激活你的虚拟环境,然后执行以下命令,把Jupyter和IPython内核装到虚拟环境里:

    pip install jupyter ipykernel
    

    这一步很关键——如果虚拟环境里没装Jupyter,VS Code会默认调用全局环境的Jupyter,自然找不到你在虚拟环境里装的包。

  • 第二步:给虚拟环境注册Jupyter内核
    激活环境后,执行命令把当前虚拟环境注册为Jupyter可用的内核:

    python -m ipykernel install --user --name=.venv --display-name="Python (.venv)"
    

    这条命令会在Jupyter的内核列表里添加一个名为Python (.venv)的选项,对应你的虚拟环境。

  • 第三步:在笔记本中切换到虚拟环境内核
    打开你的Jupyter笔记本后,有两种方式切换内核:

    1. 直接点击笔记本右上角显示的当前内核名称,在弹出的列表里选择Python (.venv);
    2. 按下Ctrl+Shift+P打开命令面板,输入Jupyter: Select Kernel,然后选择对应的虚拟环境内核。
  • 第四步:让VS Code自动识别工作区的虚拟环境
    在你的工作区目录下创建.vscode/settings.json文件,添加以下配置:

    {
      "python.defaultInterpreterPath": "${workspaceFolder}/.venv/Scripts/python.exe",
      "python.terminal.activateEnvironment": true,
      "jupyter.defaultKernelPath": "${workspaceFolder}/.venv/Scripts/python.exe"
    }
    

    这样VS Code打开工作区时会自动把虚拟环境设为默认解释器,终端打开时也会自动激活环境,Jupyter默认也会用这个内核。

  • 验证当前笔记本的环境
    在笔记本里运行以下代码,就能看到当前使用的Python路径,确认是不是虚拟环境里的:

    import sys
    print(sys.executable)
    

    如果输出是.venv/Scripts/python.exe,就说明环境切换成功了。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.08.12 23:45:34