DevContainer本地目录挂载失败问题求助

在机器学习场景中，需要将本地D盘目录挂载到Docker容器以避免在Dockerfile中复制大文件。使用docker run -it --gpus all --volume D:/tmp/test:/app/data open3d:gpu可成功挂载，但迁移到VSCode Dev Container环境时挂载失败，容器构建正常但目标目录未创建且无内容。

环境信息 #

• VSCode版本：1.77.3
• 系统：Windows 10 + Docker Desktop
• Docker版本：20.10.24

Dockerfile内容 #

# This could also be another Ubuntu or Debian based distribution
FROM nvidia/cuda:11.7.0-cudnn8-devel-ubuntu22.04

WORKDIR /app
COPY ./requirements.txt .
COPY ./requirements-torch.txt .

# 替换Ubuntu源为国内镜像
RUN sed -i -e 's/http:\/\/archive\.ubuntu\.com\/ubuntu\//mirror:\/\/mirrors\.ubuntu\.com\/mirrors\.txt/' /etc/apt/sources.list  

RUN apt-get -y update
RUN apt-get install --no-install-recommends -y libegl1 libgl1 libgomp1

# 安装Python和pip
RUN apt-get install --no-install-recommends -y \
    python3-pip \
    && rm -rf /var/lib/apt/lists/*

# 安装Open3D
RUN --mount=type=cache,target=/root/.cache \
    python3 -m pip install --upgrade pip && \
    python3 -m pip install --upgrade open3d

# 安装依赖
RUN python3 -m pip install -r requirements.txt
RUN python3 -m pip install -r requirements-torch.txt

COPY ./app /app
COPY ./tests /tests

初始devcontainer.json配置（存在语法错误） #

// For format details, see https://aka.ms/devcontainer.json. For config options, see the
// README at: https://github.com/devcontainers/templates/tree/main/src/docker-existing-dockerfile
{
    "name": "open3D-ml",
    "build": {
        "context": "..",
        "dockerfile": "../Dockerfile"
    },
    "runArgs": [
        "--gpus",
        "all"
    ],
    "mounts": [{
        "type": "bind",
        "source": "D:/tmp/test",
        "target": "/home/app/data"
    }],
    "customizations": {
        "vscode": {
            "extensions": [
                "ms-python.python"
            ]
        }
    }
// 缺失闭合的 }

已尝试的无效配置 #

1. 对象格式挂载：

"mounts": [{
    "type": "bind",
    "source": "D:/tmp/test",
    "target": "/home/app/data"
}]

2. 字符串格式挂载：

"mounts": [
  "source=D:/tmp/test,target=/home/app/data,type=bind,consistency=cached"
]

3. 将挂载参数加入runArgs：

"runArgs": [
    "--gpus",
    "all",
    "--volume",
    "D:/tmp/test:/home/app/data"
]

故障排查与解决方案 #

1. 修复devcontainer.json语法错误 #

当前配置缺失最后的闭合大括号}，导致VSCode无法正确解析配置，所有挂载设置未生效。修正后的完整配置示例：

{
    "name": "open3D-ml",
    "build": {
        "context": "..",
        "dockerfile": "../Dockerfile"
    },
    "runArgs": [
        "--gpus",
        "all"
    ],
    "mounts": [{
        "type": "bind",
        "source": "/d/tmp/test",
        "target": "/app/data"
    }],
    "customizations": {
        "vscode": {
            "extensions": [
                "ms-python.python"
            ]
        }
    }
}

2. 统一挂载路径与权限 #

• 目标路径对齐：将挂载目标路径改为与docker run一致的/app/data（Docker会自动创建不存在的目录），避免因自定义路径/home/app/data权限不足导致挂载失败。
• 提前创建目录（可选）：若坚持使用自定义目标路径，在Dockerfile中添加以下命令提前创建目录并设置权限：

RUN mkdir -p /home/app/data && chmod 777 /home/app/data

3. 检查Docker Desktop文件共享设置 #

1. 打开Docker Desktop，进入设置 > 资源 > 文件共享。
2. 确保D:盘符已被勾选，点击应用 & 重启使设置生效。

4. 调整Windows路径写法 #

在Dev Container中，Windows路径可尝试以下两种写法：

• 简化为Unix风格路径：/d/tmp/test
• 若使用WSL2后端，使用WSL挂载路径：/mnt/d/tmp/test

5. 查看容器启动日志 #

在VSCode中打开视图 > 输出，选择Dev Containers日志，查看是否有挂载相关的错误提示（如路径不存在、权限拒绝等）。

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