WSL2 + Docker 是当前 Windows 下最可控、最接近生产环境的 PHP 开发组合，但“高性能”不来自 Docker 本身，而来自绕过 Windows 文件系统、正确分配资源、避免混合路径这三件事。
直接说结论：WSL2 + Docker 是当前 Windows 下最可控、最接近生产环境的 PHP 开发组合，但“高性能”不来自 Docker 本身，而来自绕过 Windows 文件系统、正确分配资源、避免混合路径这三件事。
为什么 php -v 正常但 Web 请求 502 或超时
这是最常被忽略的路径陷阱。Docker 容器默认挂载的是 Windows 路径（如 /mnt/d/project），而 PHP-FPM 和 Nginx 对 NTFS 文件系统的 inotify 监控极差，导致重载慢、文件变更不触发、甚至 socket 连接失败。
- 把项目代码放在 WSL2 原生路径下，例如
~/workspace/myapp，再用docker run -v /home/username/workspace/myapp:/var/www/html挂载 - 禁用 Windows 文件系统自动挂载：在
/etc/wsl.conf中添加[automount] enabled = false，重启 WSL（wsl --shutdown） - 如果必须用 Windows 路径，改用
cached或delegated模式（仅限 Docker Desktop for Windows 4.19+）：-v /mnt/d/project:/var/www/html:cached
docker-compose up 启动后 Nginx 返回 502 Bad Gateway
根本原因通常是 PHP-FPM 容器没起来，或 Nginx 配置里 fastcgi_pass 指向了错误地址。WSL2 的网络模型和 Docker Desktop 的集成方式会让容器间通信变复杂。
- 确保
docker-compose.yml中 PHP-FPM 和 Nginx 在同一自定义网络（不要依赖默认bridge）：networks: appnet: driver: bridge，并在各服务中声明networks: - appnet - Nginx 配置里的
fastcgi_pass必须写成php-fpm:9000（服务名），而不是localhost:9000或127.0.0.1:9000 - 检查 PHP-FPM 日志：
docker logs myapp-php-fpm；常见报错是unable to bind listening socket，说明端口被占或用户权限不对（Ubuntu 24.04 默认用www-data用户，需确认www.conf中user/group设置一致）
如何限制 Docker 吃光 WSL2 内存导致系统卡死
WSL2 默认不限制内存，Docker Desktop 会动态分配，但一旦 PHP 应用开启 Xdebug 或 Composer install 大量包，很容易突破 8GB 甚至触发 OOM Kill。
立即学习“PHP免费学习笔记（深入）”；
- 在
%USERPROFILE%\.wslconfig中强制限制 WSL2 总内存：[wsl2] memory=6GB（16GB 主机建议值） - 给 Docker Desktop 单独设上限：Settings → Resources → Memory → 设为 ≤ 4GB（必须小于
.wslconfig值） - 在
docker-compose.yml中为每个服务加资源限制：deploy: resources: limits: memory: 1.5g（尤其对php-fpm和mysql） - 避免在容器内运行
composer install --no-dev—— 它仍会解压大量临时文件，改用docker build阶段安装依赖，运行时只保留vendor/
VS Code 调试时断点不命中、Xdebug 连不上
问题不在 Xdebug 配置本身，而在 VS Code 没连对“那个 PHP”。Windows 上装的 PHP-Xdebug 和 WSL2 容器里的 PHP-Xdebug 是两套完全独立的环境。
- 确认 Xdebug 是在容器内启用的：进 PHP-FPM 容器执行
php -m | grep xdebug，不是看 Windows 的php -m - VS Code 的
launch.json必须用容器内视角配置："pathMappings": { "/var/www/html": "${workspaceFolder}" }，且"port"要和容器内xdebug.mode=debug+xdebug.client_host=host.docker.internal匹配 - 别用
localhost当 client_host：WSL2 容器里localhost指自己，必须用host.docker.internal（Docker Desktop 自动注入）或172.17.0.1（Docker bridge 网关 IP） - 每次改 Xdebug 配置后，必须重启 PHP-FPM 容器：
docker restart myapp-php-fpm，reload不生效
真正难调的从来不是配置项，而是路径归属、网络命名空间、资源边界这三道隐形墙。只要代码不在 /mnt/ 下、容器不跨 bridge 网络瞎连、内存不放任自流，剩下的就是照着日志一行行比对的事。
