如何配置VS Code（Cursor）检测UV创建的项目内虚拟环境？

一、确认虚拟环境完整性 #

UV会在项目目录下生成指定名称的虚拟环境，先确保环境结构正常且已安装ipykernel：

• 激活虚拟环境（Mac终端）：

  source /path/to/your/project/your-venv-name/bin/activate
  

• 安装Jupyter内核依赖：

  pip install ipykernel
  

二、手动注册虚拟环境为Jupyter内核 #

自动识别失败时，手动注册是最直接的解决方案：
保持虚拟环境激活状态，执行以下命令：

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

这条命令会将当前虚拟环境的Python解释器注册到Jupyter的内核列表中。

三、修正Cursor的虚拟环境配置 #

调整「Venv Path」和「Venv Folder」时，需确保参数准确：

1. 打开Cursor设置（快捷键Cmd+,）
2. 搜索Python: Venv Path，设置为你的项目根目录（例如/Users/xxx/MyProject）
3. 搜索Python: Venv Folder，设置为UV创建的虚拟环境文件夹名称（例如你指定的.venv或自定义名称）
4. 重启Cursor后，重新打开Jupyter Notebook尝试选择内核

四、验证内核注册状态 #

执行终端命令查看已注册的Jupyter内核：

jupyter kernelspec list

如果输出中包含你注册的内核名称，说明配置生效，Cursor应能识别到该内核。

内容的提问来源于stack exchange，提问作者Areza