如何配置WSL2+VS Code与Docker容器的文件所有权 兼顾WordPress上传与代码编辑

核心问题根因 #

WSL2的文件系统是无权限映射的原生Linux文件系统，文件权限识别完全靠UID/GID数值，和用户名无关。你之前遇到的两难，本质是容器内运行PHP服务的www-data用户UID/GID，和WSL侧你的开发用户andrew的UID/GID不匹配，没有任何额外的权限转换层帮你兼容两个不同身份，所以才会出现“改容器用户服务能跑但VS Code写不了、改回原用户VS Code能用但WordPress传不了文件”的死循环。 #

具体配置步骤 #

1. 先采集两边实际的UID/GID数值 #

不要靠猜，直接用命令查实际值，避免硬编码出错：

• 在WSL终端执行，查你本地开发用户的UID/GID：

  id andrew
  

  正常Ubuntu 20.04的首个普通用户，输出格式类似uid=1000(andrew) gid=1000(andrew) groups=...，把其中uid、gid对应的数字记下来。
• 查php:7.4-fpm镜像内www-data用户的默认UID/GID：
  跑临时容器查询：

  docker run --rm php:7.4-fpm id www-data
  

  这个官方镜像默认的www-data UID/GID是33/33，和你本地用户的1000/1000差值很大，就是冲突的源头。

2. 对齐容器内服务用户的UID/GID #

核心思路：把容器内跑php-fpm的www-data用户的UID/GID，改成和你WSL本地开发用户的数值完全一致。这样两边操作文件的时候，Linux内核识别的是同一个拥有者，不存在权限差。
有两种落地方式，按你自己的使用习惯选：

方式一：启动时通过环境变量注入（零修改镜像，最省心）

php官方fpm镜像原生支持通过环境变量调整内置用户的UID/GID，直接在启动命令里加参数即可：

docker run -d \
  --name wordpress \
  -e PUID=1000 \
  -e PGID=1000 \
  -v /home/andrew/my-app/app:/var/www/html \
  php:7.4-fpm

这里的PUID、PGID替换成你第一步查出来的andrew用户的实际数值即可。如果是用docker-compose编排，只需要在对应服务的environment块里加上这两个环境变量就行。

方式二：自定义启动脚本做用户映射

如果用的是不支持PUID/PGID环境变量的定制镜像，可以在容器的启动入口脚本最前面加几行配置，启动服务前先完成用户ID对齐：

# 修改www-data的UID为本地用户的ID
usermod -u 1000 www-data
# 修改www-data的GID为本地用户的组ID
groupmod -g 1000 www-data
# 同步调整web目录下原属主的权限，避免进程启动报错
chown -R www-data:www-data /var/www
# 启动php-fpm服务
php-fpm

3. 补全上传目录的权限配置 #

你之前提到所有目录权限都是drwxr-xr-x，这个对编辑主题、插件代码完全够用，但WordPress需要往uploads目录写媒体文件、安装插件，所以需要单独给这个目录放开写入权限：

# 在WSL主机终端执行
chown -R 1000:1000 /home/andrew/my-app/app/wp-content/uploads
chmod -R 775 /home/andrew/my-app/app/wp-content/uploads

配置完成后的效果 #

• 容器内php-fpm进程运行时用的是和你WSL用户完全一致的UID，WordPress上传文件、安装插件的时候不会触发权限校验报错
• VS Code WSL Remote运行时用的也是同一个UID，编辑主题文件、保存代码的时候不会报EACCES权限拒绝

常见避坑提醒 #

• 不要直接把容器的运行用户改成1000:1000，不做用户名称映射的话，容器内1000号用户没有对应的合法用户条目，php-fpm启动时会抛警告，甚至出现进程运行权限异常
• 不要把文件属主改成容器默认的www-data（33:33），WSL主机上没有33号用户的映射，VS Code的远程服务用1000号用户操作这类755权限的文件时，会直接报无写入权限
• 不要把项目代码放在Windows侧的/mnt/c/路径下，WSL2对挂载的Windows盘权限透传是不完整的，极易出现偶发权限异常，把项目全放在WSL本地的/home/andrew/路径下稳定性最高

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