MacOS下VSCode Remote克隆仓库到容器卷出现权限报错如何解决

该报错的核心原因是：容器内/workspaces相关目录默认归属root用户所有，VSCode Remote进入容器时默认使用非root用户操作，两者权限不匹配导致写入被拒绝。

方案1：修改devcontainer.json配置（推荐） #

打开项目下.devcontainer目录中的devcontainer.json文件，新增如下配置：

• 开启UID自动匹配配置：

"updateRemoteUserUID": true

该配置会自动将容器内默认用户的UID、GID和你本地Mac用户的ID对齐，从根源解决权限不一致问题。

• 如果上述配置不生效，可额外添加启动后执行命令直接修改目录权限：

"postCreateCommand": "sudo chown -R $(id -u):$(id -g) /workspaces/my_project"

请将路径替换为你实际的工作区路径

配置修改完成后，按下F1调出VSCode命令面板，选择「Remote-Containers: Rebuild Container」重建容器，重启后即可正常操作文件。

方案2：修改镜像或编排配置 #

如果你使用自定义Dockerfile或者docker-compose启动容器，可以直接在镜像构建阶段预配置权限：

• 在Dockerfile末尾新增权限配置：

RUN mkdir -p /workspaces/my_project && chown -R vscode:vscode /workspaces/my_project

如果你的容器默认用户不是vscode，替换为实际使用的用户名即可

• 如果用docker-compose，可在对应服务下直接指定运行用户为root（不推荐，仅临时测试用）：

services:
  app:
    user: root

临时验证方法 #

如果需要先确认问题根因，可以在容器内的终端执行命令：
sudo chown -R $(whoami) /workspaces/my_project
执行后尝试创建文件，如果操作正常即可确认是权限匹配问题，再选择上面的永久方案配置即可。

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