WebStorm如何配置Docker容器开发-webstorm-PHP中文网

webstorm docker开发需启用docker插件并重启ide才能显示services中的docker节点；连接失败主因是socket路径不匹配，须按系统环境（colima/wsl2/远程）配置正确docker连接类型与地址；代码修改生效需手动配置volume挂载，调试node.js容器需设置远程解释器并确保--inspect端口映射一致。

webstorm如何配置docker容器开发

WebStorm 能直接用于 Docker 容器开发，但不是“点一下就连上容器”，而是靠插件驱动整条链路：构建镜像 → 启动容器 → 挂载代码 → 调试进程。第一步卡住，后面全白搭。

为什么 Services 里看不到 Docker 节点？

90% 的人在这一步失败，根本原因只有一个：Docker 插件没启用或没重启 IDE。

打开 Ctrl+Alt+S → Plugins → 切到 Installed 标签页
搜 Docker，确认复选框已勾选（哪怕显示 “Bundled”）
必须重启 WebStorm，否则 Services 窗口永远不出现 Docker 图标
验证方式：View → Tool Windows → Services（或 Alt+8）能看到 Docker 节点

连接 Docker daemon 总是失败？查 socket 路径类型

WebStorm 默认尝试连 /var/run/docker.sock，但 macOS 用 Colima、Windows 用 WSL2 时，这个路径根本不存在——连不上不是网络问题，是地址写错了。

Docker Desktop

Docker Desktop 可用于构建容器化 PHP 开发环境，适合 Laravel、Symfony、WordPress 等项目统一运行依赖。

下载

进 Ctrl+Alt+S → Build, Execution, Deployment → Docker
点 + 添加配置，类型必须匹配你的真实环境：
- macOS + Colima → 选 TCP socket，填 unix:///Users/xxx/.colima/docker.sock
- Windows + WSL2 → 选 WSL2-based engine，别填 TCP 地址
- 远程服务器 → 选 TCP socket，填 tcp://192.168.x.x:2375，且远端 dockerd 必须加 -H tcp://0.0.0.0:2375 启动并放行防火墙
对话框底部出现 Connection successful 才算真正通了；没这行字，别往下配 registry 或 run 配置

改了代码，容器里还是旧逻辑？默认不挂载源码

点击 Run Dockerfile 只做两件事：docker build → docker run 新容器。它不会自动把本地文件同步进正在运行的容器里。

要实现“保存即生效”，必须手动加 volume 映射：
- 右键 Dockerfile → Edit Configurations…
- 展开 Container settings → Volume bindings → 点 +
- 填宿主机路径（如 ./src）→ 容器内路径（如 /app/src）
注意权限问题：Linux/macOS 容器内进程 UID 和宿主机不一致时，可能无写入权限；可在 Environment variables 加 NODE_OPTIONS=--no-warnings 或在 User 字段填 1001:1001
Java 项目同理：挂载 ./out/production/MyApp/ 到容器内对应 classpath 路径，再配合 java -cp 或热加载工具

调试 Node.js 容器报 “Cannot connect to runtime process”？远程解释器没对

这不是 Docker 连接问题，而是 WebStorm 的 Node.js 运行时指向了本地，而非容器内环境。

进 Ctrl+Alt+S → Languages & Frameworks → Node.js and NPM
Node interpreter 下拉框选 Add… → Remote Host
类型选 Docker，Server 选你已配好的 Docker 连接，Image name 填你用的镜像（如 node:22）
确保容器内 Node.js 启动时加了 --inspect=0.0.0.0:9229，且 EXPOSE 9229 并映射端口（如 -p 9229:9229）
调试配置里的 Port 必须和容器内 --inspect 指定的端口一致