如何让VS Code的Go to Definition跳转至工作区Python库文件而非虚拟环境文件

云原生阿岚

2026-6-13

解决VS Code中Go to Definition跳转本地Git仓库源码的问题

步骤1：正确以可编辑模式安装Airspace

激活Multitenant的虚拟环境：

source ~/dev/multitenant/.venv/bin/activate  # Linux/macOS
# Windows 下执行：
# ~/dev/multitenant/.venv/Scripts/activate

使用绝对路径安装可编辑模式的Airspace，避免相对路径解析问题：
```
uv pip install -e ~/dev/airspace
```
验证安装结果：执行pip list，确认Airspace条目后显示(editable from ~/dev/airspace)

步骤2：配置VS Code Python分析器优先识别工作区源码

打开VS Code设置（快捷键Ctrl+,），编辑settings.json，添加以下配置：

{
  "python.analysis.extraPaths": [
    "/home/你的用户名/dev/airspace"  // 替换为你的Airspace绝对路径，Windows用"C:\\Users\\你的用户名\\dev\\airspace"
  ],
  "python.analysis.packageIndexDepths": [
    {
      "name": "airspace",
      "depth": 2
    }
  ],
  "python.analysis.useLibraryCodeForTypes": false
}

extraPaths：指定Airspace的源码根目录，让分析器能定位到本地源码
packageIndexDepths：确保分析器深入解析Airspace包的层级结构
useLibraryCodeForTypes：禁用优先使用虚拟环境库代码，强制分析器采用工作区本地源码

步骤3：重启VS Code并清除缓存

按Ctrl+Shift+P，执行Python: Clear Cache and Reload Window，彻底刷新分析器缓存和窗口

步骤4：确认工作区与解释器配置

检查两个仓库（~/dev/multitenant、~/dev/airspace）均已加入当前VS Code工作区
右下角确认选中的Python解释器是Multitenant的虚拟环境：~/dev/multitenant/.venv/bin/python（Linux/macOS）或对应Windows路径