VS Code Dev Containers 怎样为项目指定工作区挂载目录

如果项目放在单仓库、子目录或需要使用命名卷，VS Code Dev Containers 默认的工作区挂载位置可能不够明确。解决方法是在 devcontainer.json 中显式设置 workspaceMount，再用 workspaceFolder 告诉编辑器进入容器后的工作区目录。

官方文档地址：https://code.visualstudio.com/remote/advancedcontainers/change-default-source-mount。下面的界面图是原创静态说明图，不是 VS Code 截图。

最小配置可以写成：把宿主机项目下的 app 目录以 bind mount 挂到容器的 /workspace，并把 workspaceFolder 同样设为 /workspace。修改后重建容器，最后按资源树和容器内路径确认是否生效。

先确认默认挂载与目标边界

当 devcontainer.json 使用 image 或 dockerFile 创建容器时，Dev Containers 会自动把当前工作区绑定到容器中。官方说明还区分了 Git 仓库根目录和配置文件所在目录：主机上能找到 Git 时，默认工作区可能是仓库根；找不到时则可能使用包含配置文件的目录。

需要改变默认行为时，再显式写 workspaceMount。这个字段采用 Docker CLI --mount 的值格式，重点是把宿主机来源 source、容器目标 target 和挂载类型 type 写清楚；workspaceFolder 则应指向容器内真正要打开的目录。

准备 devcontainer.json 配置

在项目的 .devcontainer/devcontainer.json 中加入下面配置。这里的 localWorkspaceFolder 代表本地打开的工作区目录，示例只取其中的 app 子目录作为挂载源。

{
  // 把宿主机工作区下的 app 子目录绑定到容器目标目录
  "workspaceMount": "source=${localWorkspaceFolder}/app,target=/workspace,type=bind",
  // 让编辑器进入与 target 一致的容器工作区
  "workspaceFolder": "/workspace"
}

如果希望挂载整个项目，把 source 改为 ${localWorkspaceFolder}；如果要用命名卷，则可以把 type 换成 volume，并让 source 使用卷名。不要把宿主机绝对路径硬编码进仓库，否则换电脑后配置很难复用。

重建容器加载新挂载

只保存配置文件并不会自动改变已经创建好的容器。回到 VS Code 命令面板，执行 Dev Containers: Rebuild Container，等待容器重新构建并重新连接。官方文档也建议，对于已经构建并连接的容器使用这个命令；首次打开则可以使用 Dev Containers: Open Folder in Container...。

操作路径：
1. 打开命令面板
2. 选择 Dev Containers: Rebuild Container
3. 等待窗口重新连接到容器
4. 打开容器内的 /workspace 目录

结果：工作区重新挂载到配置中的 target 路径

这里的关键不是看到“重建完成”几个字，而是重新连接后的工作区路径是否与 workspaceFolder 一致。若仍停留在旧目录，先确认重建命令作用于当前项目窗口，而不是另一个已打开的容器窗口。

按路径确认工作区已切换

验收时可以同时看三个位置：资源树中项目文件是否出现在预期目录、编辑器工作区路径是否显示为 /workspace、状态区是否已经重新连接到目标容器。三者对应起来，才能判断挂载源和目标目录形成了完整链路。

如果主机的 app 目录中有一个容易识别的项目文件，可以用它作为路径判断依据；不要只根据容器启动成功就认为挂载正确，因为容器本身能启动并不代表编辑器打开的是目标目录。

路径或权限不生效时怎么排查

1. 检查配置位置：确认当前窗口使用的确实是项目中的 .devcontainer/devcontainer.json，而不是另一个工作区或旧配置。
2. 检查四个值：逐个核对 source、target、type 和 workspaceFolder；尤其不要把主机路径误写成容器路径。
3. 检查变量展开：优先使用 localWorkspaceFolder 这类变量，避免把只在当前电脑存在的绝对路径提交到仓库。
4. 重新执行重建：修改后再次运行 Dev Containers: Rebuild Container，仅重新连接窗口通常不会重新读取所有挂载参数。
5. 区分挂载类型：bind mount 依赖主机目录；命名卷不等同于主机目录，首次使用时看到的内容和权限模型可能不同。

最终可以用下面的速查表记录判断依据：

相关问题

workspaceMount 一定要和 workspaceFolder 同时设置吗？

不一定，但两者承担的职责不同。前者决定挂载关系，后者决定编辑器进入哪个容器目录；如果目标路径不是默认工作区，通常一起设置更容易避免窗口打开到错误位置。

为什么改了 devcontainer.json 仍然看到旧目录？

最常见原因是只重新连接而没有重建容器，或者当前窗口引用了另一份配置。先确认配置文件路径，再执行 Rebuild Container，并按容器内目标路径重新检查。

能不能把 workspaceMount 写成宿主机绝对路径？

技术上可以，但团队项目不建议这样做。绝对路径通常只适合个人临时环境；可提交的配置优先使用工作区变量或命名卷，让换电脑和协作场景更稳定。