如何配置VS Code Dev Container优先使用符号链接而非链接目标？

在Dev Container环境中，当你用~/src符号链接指向挂载的/work/src目录时，VS Code偶尔会自动解析符号链接为绝对路径，导致同一个文件以~/src/xxx和/work/src/xxx两种路径存在，调试断点无法共用。可以通过以下几个配置解决：

1. 关闭VS Code的符号链接解析 #

VS Code默认会将符号链接解析为真实路径，修改这个全局设置就能保留符号链接的路径：

• 在容器内打开VS Code设置（Ctrl+,），搜索files.useCanonicalPath，将其设置为false。
• 要持久化这个配置，在.devcontainer/devcontainer.json中添加：

  {
    "settings": {
      "files.useCanonicalPath": false
    }
  }
  

2. 配置调试器的路径映射（按需） #

如果关闭符号链接解析后仍有问题，需要给调试器添加路径映射，强制将/work/src的路径映射到工作区的~/src：

• 打开.vscode/launch.json，在对应调试配置中添加sourceMapPathOverrides（以Node.js为例）：

  {
    "configurations": [
      {
        "type": "node",
        "request": "launch",
        "name": "启动程序",
        "program": "${workspaceFolder}/app.js",
        "sourceMapPathOverrides": {
          "/work/src/*": "${workspaceFolder}/*"
        }
      }
    ]
  }
  

  其他语言的调试器（如Python、Go）也有类似的路径映射配置，核心是将挂载目录的绝对路径映射到符号链接的工作区路径。

3. 确保默认打开符号链接目录 #

在devcontainer.json中指定默认工作区为符号链接目录，避免手动打开时误选真实路径：

{
  "workspaceFolder": "${localEnv:HOME}/src"
}

这样每次启动Dev Container时，VS Code会自动打开~/src，而非/work/src。

这些配置组合起来，就能让VS Code始终使用符号链接的路径标识文件，保证断点在调试过程中正常共用。

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