VS Code DevContainer非Root用户下/workspace权限配置问题

问题根源 #

你之前尝试的方法失效的原因：

• Dockerfile中提前创建/workspace并修改权限：挂载命名卷时，卷的默认内容会覆盖容器内的目录，原有权限设置被清空。
• postStartCommand/postCreateCommand以普通用户执行：这些命令是切换到非Root用户后运行的，无修改目录所有权的权限。
• 卷权限参数格式错误：之前的volume-opt写法不符合Docker要求，需每个权限选项单独声明。

可行解决方案 #

方案1：利用onCreateCommand（推荐，最简）

onCreateCommand是容器创建后、切换到指定用户前执行的命令，默认以Root身份运行，直接修改目录权限即可：
修改.devcontainer.json：

{
    "name": "Debian MinGW w64",
    "image": "shockagent/debian-mingw-w64:latest",
    "shutdownAction": "stopContainer",
    "workspaceMount": "source=vscode-workspace,target=/workspace,type=volume",
    "workspaceFolder": "/workspace",
    "onCreateCommand": "chown -R 1000:1000 /workspace"
}

若需从本地环境动态读取UID/GID，可改为：

"onCreateCommand": "chown -R ${localEnv:USER_UID}:${localEnv:USER_GID} /workspace"

（需本地提前设置USER_UID和USER_GID环境变量）

方案2：给普通用户添加免密sudo权限

修改Dockerfile，安装sudo并配置免密权限：

FROM debian:testing-slim

ARG USERNAME=myuser
ARG USER_UID=1000
ARG USER_GID=$USER_UID

RUN apt-get update \
&& apt-get install --no-install-recommends --assume-yes \
mingw-w64 \
git \
sudo

RUN groupadd --gid $USER_GID $USERNAME \
&& useradd --uid $USER_UID --gid $USER_GID -m $USERNAME \
&& echo "$USERNAME ALL=(ALL) NOPASSWD:ALL" >> /etc/sudoers.d/$USERNAME \
&& chmod 0440 /etc/sudoers.d/$USERNAME

USER $USERNAME

然后在.devcontainer.json中用sudo执行权限修改：

"postCreateCommand": "sudo chown -R 1000:1000 /workspace"

方案3：配置卷的权限参数（仅支持兼容卷驱动）

调整workspaceMount的参数格式，正确添加卷权限选项：

"workspaceMount": "source=vscode-workspace,target=/workspace,type=volume,volume-opt=uid=1000,volume-opt=gid=1000"

该方法要求你的Docker卷驱动支持uid/gid选项（默认的local驱动支持），若之前尝试无效，大概率是参数格式错误导致。

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