WSL2中VSCode Dev Container拉取镜像时遇Docker凭证错误

问题背景 #

在WSL2环境下使用VSCode Dev Container时，执行initializeCommand拉取GHCR镜像时报错：

Start: Run: /bin/sh -c docker pull ghcr.io/mycompany/dev-environment/devcontainer:latest
/usr/bin/docker-credential-desktop.exe: Invalid argument
Error response from daemon: Head "https://ghcr.io/v2/mycompany/dev-environment/devcontainer/manifests/latest": denied

仅在Windows用户目录（/mnt/c/Users/myuser）下可正常执行，离开该目录则报错，根源是WSL本地~/.docker目录与Windows端.docker配置冲突，导致无法正确读取Windows的Docker凭证。

解决方案 #

通过将WSL的.docker目录软链接到Windows端的配置目录，强制WSL始终使用Windows的凭证：

1. 备份WSL本地Docker配置
   先备份原有配置，防止数据丢失：

   mv ~/.docker ~/.docker.backup
   

2. 创建软链接指向Windows Docker配置
   将WSL用户目录下的.docker链接到Windows用户的.docker目录（替换myuser为你的Windows用户名）：

   ln -s /mnt/c/Users/myuser/.docker ~/.docker
   

3. 验证配置生效

   • 关闭当前WSL终端，重新打开
   • 在任意目录执行docker pull ghcr.io/mycompany/dev-environment/devcontainer:latest测试
   • 重启VSCode并重建Dev Container，确认initializeCommand可正常执行

注意事项 #

• 确保Windows端Docker已完成ghcr.io的登录验证（可在Windows终端执行docker login ghcr.io确认）
• 若之前在WSL中单独执行过docker login，备份后的本地配置可直接删除，避免残留凭证干扰
• 软链接生效后，WSL中所有Docker操作将统一使用Windows的凭证与配置，保持跨环境一致性

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