无网络环境下如何用Visual Studio调试Windows Docker容器

问题分析 #

Visual Studio调试Windows Docker容器时，会自动联网拉取OneCore.Msvsmon调试组件到容器内的C:\.vs-debugger目录。无网络环境下该下载操作失败（错误码0x6），直接复制压缩包或解压的方式不符合VS的检测逻辑，导致无法正常连接。

手动配置步骤 #

1. 匹配调试包与Visual Studio版本

• VS2019对应16.x系列调试包，VS2022对应17.x系列，必须确保下载的调试包版本和你的VS版本完全一致（可通过VS菜单「帮助」→「关于」查看具体版本号，比如VS2019 16.11需下载16.11版本的包）。

2. 正确部署调试包到容器

• 创建目录：在容器内生成指定调试目录（若不存在）：

  docker exec -i <container_name> mkdir C:\.vs-debugger
  

• 复制压缩包：将提前下载好的OneCore.Msvsmon.amd64.enu.zip复制到容器目录：

  docker cp OneCore.Msvsmon.amd64.enu.zip <container_name>:C:\.vs-debugger\
  

• 解压并确保文件结构：在容器内执行解压命令，强制覆盖到目标目录（关键：解压后msvsmon.exe需直接位于C:\.vs-debugger下，不能嵌套子文件夹）：

  docker exec -i <container_name> powershell Expand-Archive -Path C:\.vs-debugger\OneCore.Msvsmon.amd64.enu.zip -DestinationPath C:\.vs-debugger\ -Force
  

3. 标记调试器就绪

VS通过检测特定文件判断调试组件是否部署完成，手动创建标记文件：

docker exec -i <container_name> echo ready > C:\.vs-debugger\debugger-ready

4. 验证权限并重启VS

• 确保调试器可执行文件权限正常：

  docker exec -i <container_name> icacls C:\.vs-debugger\msvsmon.exe /grant Everyone:F
  

• 关闭当前VS的「附加到进程」对话框，重启Visual Studio后重新尝试附加容器进程。

注意事项 #

• 调试包版本与VS版本必须严格匹配，版本不匹配会导致连接失败；
• 不要修改C:\.vs-debugger目录的路径或名称，VS会固定查找该位置；
• 若使用PowerShell执行容器命令，需确保容器内已预装PowerShell（Windows Server Core镜像默认包含）。

内容的提问来源于stack exchange，提问作者Greg Loomis