如何在VSCode Remote Containers中正确使用自定义镜像并解决权限与挂载问题

一、容器用户权限不一致问题修复 #

问题根因 #

• 硬编码的容器用户UID/GID和本地普通用户的UID/GID不匹配
• 容器内默认umask为022，本地普通用户umask通常为002，导致新建文件权限位差异

修复步骤 #

1. 动态传递本地用户UID/GID到容器构建流程，不要固定用户ID
2. 统一容器内用户的umask和本地一致

配置修改示例 #

修改后的.devcontainer/devcontainer.json：

{
    "name": "Babel",
    "build": {
        "dockerfile": "Dockerfile",
        // 新增构建参数，传递本地用户的UID和GID
        "args": {
            "LOCAL_UID": "${localEnv:UID}",
            "LOCAL_GID": "${localEnv:GID}"
        }
    },
    "runArgs": [
        "--cap-add=SYS_PTRACE",
        "--security-opt",
        "seccomp=unconfined"
    ],
    "extensions": [
        "ms-vscode.cpptools",
        "ms-vscode.cmake-tools",
        "twxs.cmake"
    ],
    "remoteUser": "babel",
    // 新增环境变量，设置umask为002，和本地普通用户一致
    "remoteEnv": {
        "UMASK": "002"
    },
    // 调整挂载路径，解决挂载覆盖问题，见第二部分
    "workspaceMount": "type=bind,source=${localWorkspaceFolder},target=/home/babel/workspace",
    "workspaceFolder": "/home/babel/workspace"
}

修改后的.devcontainer/Dockerfile：

# Using the latest epitech image
FROM epitechcontent/epitest-docker

# 接收构建参数
ARG LOCAL_UID=1000
ARG LOCAL_GID=1000

# 先创建对应GID的用户组，再创建用户，UID/GID和本地一致
RUN groupadd -g ${LOCAL_GID} babel \
    && useradd -rm -d /home/babel -s /bin/zsh -g babel -G root -u ${LOCAL_UID} babel

# 构建生成的文件不要放在后续要挂载的目录下，先存到临时目录
RUN mkdir -p /opt/build-assets \
    && touch /opt/build-assets/dummyfile

WORKDIR /home/babel

二、挂载操作覆盖原有文件问题修复 #

问题根因 #

bind挂载机制会直接将本地目录覆盖到容器指定路径，路径下原有构建生成的内容会被隐藏，无法直接访问。

两种可选修复方案 #

• 方案1（更推荐）：调整挂载路径为家目录的子目录，如/home/babel/workspace，家目录下的构建内容不会被覆盖，对应上面配置示例的修改即可
• 方案2：如果必须挂载到家目录，可将构建阶段生成的文件先存在非挂载目录，通过postCreateCommand在容器启动、挂载完成后复制到目标路径，示例如下：

// 在devcontainer.json中新增配置
"postCreateCommand": "cp /opt/build-assets/dummyfile /home/babel/"

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