如何在VS Code中自动加载PEP-723风格的虚拟环境

我之前也被这个问题困扰过——用uv写了PEP-723风格的自包含脚本，结果在VS Code里Pylance一直报找不到依赖，手动切虚拟环境又麻烦。后来摸索出几个实用的办法，帮你实现自动加载：

方法一：生成本地虚拟环境让VS Code自动检测 #

这是我最常用的方案，简单直接：

• 首先，利用uv的命令，直接从你的PEP-723脚本生成本地虚拟环境。在脚本所在目录打开终端，执行：

  uv venv .venv --from-script your_script.py
  

  这个命令会读取脚本顶部的/// script元数据，把指定的duckdb、pandas这些依赖都装到当前目录的.venv文件夹里。
• VS Code有个默认行为：只要目录里有.venv，它会自动检测到这个虚拟环境，右下角会弹出提示让你切换过去。选一次之后，VS Code会在工作区设置里记住这个选择，下次打开这个脚本时就会自动加载对应的venv，Pylance也能正常识别依赖了。
• 要是想彻底解放双手，不用每次手动输命令，可以给VS Code加个自动执行的任务：
  1. 打开命令面板（Ctrl+Shift+P），选「任务: 打开工作区任务」。
  2. 选择「创建tasks.json文件」，然后选「Others」模板。
  3. 把模板内容替换成下面的代码：

     {
       "version": "2.0.0",
       "tasks": [
         {
           "label": "自动创建PEP-723虚拟环境",
           "type": "shell",
           "command": "uv venv .venv --from-script ${file}",
           "problemMatcher": [],
           "runOptions": {
             "runOn": "folderOpen"
           }
         }
       ]
     }
     

     这样每次打开这个脚本所在的文件夹时，VS Code会自动执行命令生成venv，完全不用你手动操作。不过要注意：如果一个文件夹里有多个不同依赖的PEP-723脚本，这个方法会覆盖.venv，所以更适合单脚本的场景。

方法二：直接复用uv的缓存虚拟环境 #

uv默认会把PEP-723脚本的虚拟环境存在本地缓存里，我们也可以让VS Code直接用这个缓存的venv：

• 先执行这个命令，获取当前脚本对应的venv的Python解释器路径：

  uv run --print-interpreter your_script.py
  

  它会输出类似/home/yourname/.cache/uv/venvs/xxxx/bin/python这样的路径。
• 打开VS Code的工作区设置（在脚本目录下创建.vscode/settings.json），把刚才的路径填进去：

  {
    "python.pythonPath": "/home/yourname/.cache/uv/venvs/xxxx/bin/python"
  }
  

  这样下次打开脚本时，VS Code会直接用这个缓存里的venv。不过这个路径是每个脚本独有的，要是你有多个不同的PEP-723脚本，得给每个脚本单独配置工作区设置。

方法三：借助社区插件简化操作 #

现在VS Code社区里有针对uv的专用插件，有些可以自动识别脚本里的PEP-723元数据，自动生成并切换对应的虚拟环境，不用你手动敲命令或者改配置。你可以在扩展商店里搜索「uv」，找那些下载量高、维护活跃的插件试试，能省不少事。

备注：内容来源于stack exchange，提问作者foglerit