VS Code符号链接目录下Python文件跳转定义路径异常求助

DevOps 小满

2026-7-6

解决VS Code Python扩展跳转到符号链接真实路径的问题

下面是几个可行的解决方案：

修改VS Code路径解析设置
打开VS Code设置界面（快捷键Ctrl+,），搜索files.useRealPath并将其设为false。这个设置会让VS Code优先使用符号链接路径而非真实路径，Python扩展的"转到定义"操作就会跳转到~/Git/project路径下的文件。
也可以直接在工作区的.vscode/settings.json中添加配置：
```
{
    "files.useRealPath": false
}
```
配置Python语言服务器路径映射
如果上述设置无效，可通过Python扩展的路径映射强制转换路径。在.vscode/settings.json中添加：
```
{
    "python.analysis.pathMapping": {
        "/mnt/extra-drive/Git": "${workspaceFolder}"
    }
}
```
${workspaceFolder}会自动替换为当前打开的~/Git工作区路径，Python语言服务器解析定义时会将真实路径转换为符号链接路径，确保跳转后文件在资源管理器中正常显示。
用绑定挂载替代符号链接（可选）
若愿意调整目录挂载方式，可使用系统绑定挂载让两个目录在系统层面视为同一路径，从根源解决路径不一致问题。执行以下命令（需root权限）：
```
sudo mount --bind /mnt/extra-drive/Git ~/Git
```
如需重启后自动生效，在/etc/fstab中添加一行：
```
/mnt/extra-drive/Git  /home/你的用户名/Git  none  bind  0  0
```