无Docker Desktop时VS2022使用Docker构建出现卷挂载错误

核心问题 #

WSL2环境下的Docker daemon运行在Linux内核中，仅支持Linux风格路径（如/mnt/c/...），但VS2022自动生成的容器运行命令使用Windows本地路径（如C:\Users\...），导致路径解析失败，触发卷挂载错误与CTC1003提示。此外手动配置Docker CLI时缺少Docker Desktop自带的权限自动配置（如docker-user组），进一步引发权限相关问题。

解决方案 #

1. 改用Docker Desktop的WSL集成（优先推荐） #

• 删除手动配置的Docker上下文：

  docker context rm [你的WSL上下文名称]
  

• 安装Docker Desktop，启用WSL集成：
  • 打开Docker Desktop设置，进入资源 > WSL集成
  • 勾选正在使用的WSL发行版（如Ubuntu），点击应用
• 重启VS2022后，Docker Desktop会自动处理Windows与WSL路径的转换，VS生成的挂载命令将被正确解析，同时自动创建docker-user组并配置权限，解决CTC1003错误。

2. 手动路径转换适配（仅当无法使用Docker Desktop时） #

通过WSL命令中转Docker调用，实现自动路径转换：

• 创建docker-wsl.bat脚本，内容如下：

  @echo off
  wsl docker %*
  

• 将该脚本所在目录添加到Windows系统PATH的最前端，确保VS2022优先调用此脚本
• 这样VS生成的Windows路径会被WSL自动转换为/mnt格式的Linux路径，卷挂载命令即可正常执行

补充说明 #

• docker build能正常执行是因为构建上下文通过网络传输至daemon，无需挂载本地卷；而docker run的卷挂载需要daemon直接访问本地路径，因此路径格式错误会直接导致失败
• 手动创建docker-user组是因为Docker Desktop会自动完成此配置，而原生Docker CLI无该自动逻辑

内容的提问来源于stack exchange，提问作者Falco Alexander