WSL终端+VSCode环境下Docker Desktop文件复制报错求助

核心原因 #

Docker Desktop在WSL终端中运行时，若路径格式处理不当，会错误将WSL的/mnt路径解析为Windows本地的C:\mnt（该路径实际不存在），进而触发文件找不到的报错。

操作排查与修正 #

1. 修正docker cp命令的路径格式 #

• 错误示例：直接使用WSL路径但未适配Docker的路径映射逻辑

  docker cp /mnt/c/Users/xxx/file.txt container_name:/target/path
  

  这种写法下，Docker会误把/mnt/c识别为Windows的C:\mnt\c，而非正确的WindowsC:\盘路径。

• 正确写法：

  • 方法一：用wslpath -w工具将WSL路径转为Windows绝对路径

    docker cp $(wslpath -w /mnt/c/Users/xxx/file.txt) container_name:/target/path
    

  • 方法二：直接使用Windows原生路径格式（注意转义反斜杠或用正斜杠）

    docker cp C:\\Users\\xxx\\file.txt container_name:/target/path
    # 或简化为正斜杠格式
    docker cp C:/Users/xxx/file.txt container_name:/target/path
    

2. 确认Docker Desktop的WSL集成状态 #

打开Docker Desktop设置 → 资源 → WSL集成，确保你正在使用的WSL发行版（如Ubuntu）开关已开启，这是Docker正确识别WSL与Windows路径映射的前提。

3. 验证路径解析是否正确 #

在WSL终端中先执行ls /mnt/c/Users/xxx/file.txt确认文件存在，再执行wslpath -w /mnt/c/Users/xxx/file.txt，检查输出是否为正确的C:\Users\xxx\file.txt，而非错误的C:\mnt\...格式。

4. 避免混合路径语法 #

不要在命令中混用WSL和Windows路径的书写规则，比如/mnt/c/Users/xxx\file.txt这类格式会直接导致Docker路径解析混乱。

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