phpstorm怎么使用Code With Me进行远程协作（多人编程）-phpstorm-PHP中文网

code with me是jetbrains ide内置的实时协作工具，采用“主机-宾客”架构，主机共享本地项目，宾客通过轻量客户端加入，无需配置环境；自2026.1版本起将降级为独立插件，2027年q1彻底关停服务。

phpstorm怎么使用code with me进行远程协作（多人编程）

Code With Me 不是远程开发，也不是 SSH 连接远程服务器；它是主机共享本地项目、访客通过轻量客户端实时协作的机制。只要主机能跑 PhpStorm（2020.2.1+），访客连 IDE 都不用装。

主机必须在已打开项目的 PhpStorm 中操作，不能从欢迎页或空工作区启动：

点击菜单 Tools → Code With Me → Start Session，或使用快捷键 Ctrl+Alt+S（Windows/Linux）/Cmd+Option+S（macOS）
在弹出窗口中选择权限模式：Read-only（只读）、Edit files（仅编辑）、Full access（含终端/调试/运行），不建议直接选 Full access 给不信任的访客
勾选 Enable port forwarding 并添加端口（如 3000、8080），否则访客无法在自己浏览器访问主机起的服务
点 Enable Access 后复制生成的链接——这个链接带一次性 token，24 小时内有效，且仅限首次成功连接后自动失效

访客点击链接后会自动下载 JetBrains Client（约 600KB），不是浏览器插件，也不是网页版 IDE。常见连不上原因：

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

主机防火墙或公司网络屏蔽了 https://code-with-me.jetbrains.com 或 https://download.jetbrains.com，导致客户端无法拉取必要资源
访客点击链接后没等下载完成就手动关闭了下载页，或浏览器拦截了自动下载（尤其 Safari 和部分国产浏览器）
主机未点击弹窗中的 Accept 按钮——访客客户端启动后，主机 IDE 右下角会弹确认框，不点就卡在“connecting…”
访客用的是旧版 JetBrains Client（比如从其他项目缓存残留的），建议清空 ~/.cache/JetBrains/CodeWithMe（Linux/macOS）或 %LOCALAPPDATA%\JetBrains\CodeWithMe（Windows）再试

即使启用了端口转发，访客在自己机器访问 http://localhost:3000 仍显示拒绝连接，大概率是以下其一：

主机上服务根本没起来，或者监听的是 127.0.0.1:3000 而非 0.0.0.0:3000；Code With Me 只转发已绑定到 0.0.0.0 的端口
主机开了 Docker，但容器内服务绑定了 host.docker.internal，这个地址对 Code With Me 的端口转发无效，得改回 0.0.0.0
主机系统有多个网卡（比如同时连 WiFi 和以太网），PhpStorm 默认只监听主网卡，可在 Help → Edit Custom Properties… 加一行：code.with.me.bind.address=0.0.0.0，然后重启 IDE
转发端口被主机本地其他进程占用（比如另一个 Node 服务），此时 PhpStorm 不报错，但访客访问会超时

这些不是网络问题，而是权限或插件限制导致的隐性行为：

访客看不到终端或无法执行 Run 操作，说明主机设的是 Edit files 权限——该模式禁止访问终端、运行配置、调试器
多人同时编辑同一行代码时出现“冲突标记”（如 ），这不是 Git 冲突，是 Code With Me 的实时合并失败，建议避免高频重叠编辑，或由一人暂代“主编辑”角色
访客无法触发 Xdebug 断点，因为调试器只在主机侧运行，访客只能看状态、不能单步；若需共同调试，主机得开 Full access 并确保访客也安装了匹配的 Xdebug Helper 浏览器插件（仅辅助触发）
主机装了自定义插件（比如 PHP Annotations 或 Laravel Plugin），访客端不会加载——Code With Me 不同步插件，只同步项目文件和基础 IDE 功能

最易被忽略的一点：Code With Me 的所有协作行为都依赖主机本地项目索引是否完整。如果主机刚打开项目就开共享，而 PhpStorm 还在后台扫描 vendor 或构建索引，访客可能看到文件列表为空、补全失效、甚至无法跳转定义——务必等右下角索引进度条消失后再启用会话。