goland 的 code with me 插件需 2021.1+ 版本且必须启用，协同编辑不转发调试进程、不共享环境变量，guest 无真实运行能力，权限应设为 custom 以禁用终端和运行配置。
Code With Me 插件没启用或版本不匹配
GoLand 默认不预装 Code With Me 插件，且它对 IDE 版本有硬性要求：必须是 GoLand 2021.1 或更高版本，官方推荐使用 2026.1（当前最新稳定版）。低于 2021.1 的版本无法安装该插件；高于 2026.1 的 EAP 版本可能因插件未同步更新而报错 “Plugin not compatible”。
检查方式：Help → Find Action → 输入 "Plugins"，在 Marketplace 标签页搜索 Code With Me，确认状态为 “Installed” 且右侧显示 “Enabled”。若未安装，点击 Install 并重启 IDE。
- 不要从第三方渠道下载插件 ZIP 文件手动安装——签名校验会失败，IDE 启动时直接禁用
- 如果你用的是 JetBrains Toolbox 管理 GoLand，确保 Toolbox 已登录 JetBrains 账户，否则插件市场可能灰显
- 插件启用后，主工具栏右上角会出现一个双人图标
?；没有该图标说明插件未生效
邀请链接打不开或客户端卡在“Waiting for host”
Guest 端点击邀请链接后自动下载的是 JetBrains Client（约 600KB 的轻量应用），不是完整 IDE。常见失败原因是 Host 端未真正“开启访问”，或网络策略拦截了 WebSocket 连接。
关键动作顺序必须是：Tools → Code With Me → Enable Access and Copy Invitation Link，而不是只点共享图标就复制链接。复制前务必确认弹窗中 “Enable Access” 按钮已变为蓝色并显示 “Access enabled”。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- Host 端防火墙或公司代理可能阻断
localhost:59000+范围端口——这是 JetBrains Client 默认通信端口，可临时关闭防火墙验证 - Guest 端浏览器若为 Firefox 或 Safari，需允许弹出窗口和文件下载；Chrome 下有时需手动允许“不安全脚本”（地址栏左侧锁形图标）
- 如果 Guest 已下载客户端但始终卡在等待界面，Host 端检查右下角状态栏是否显示 “Code With Me: Active”；若显示 “Idle”，说明未真正启动会话
协同编辑时断点不命中、调试器失效
Code With Me 是 IDE 界面与操作流的实时同步，**不转发远程调试进程**。也就是说，Guest 可以看到 Host 的 Debug 工具窗口、断点标记、变量值面板，但所有调试控制（Step Over / Resume / Evaluate Expression）必须由 Host 执行。Guest 点击调试按钮无效，也看不到真实运行时堆栈。
这跟 VS Code Remote-SSH 或 GoLand 的 Remote Interpreter 完全不同：后者是在远程机器上真实运行 dlv，而 Code With Me 的调试能力完全依赖 Host 本地环境。
- Host 必须已正确配置 Go SDK 和
GOROOT，且项目能本地正常 debug；Guest 无需安装 Go 或 Delve - 如果 Host 用的是 Docker 容器内开发（比如 Remote-Containers），
Code With Me无法穿透容器网络，此时应改用Remote-SSH+Delve组合 - Guest 编辑代码后，Host 的 “Build” 或 “Run” 操作仍走本地构建流程——确保 Host 的
GOBIN、GO_PROXY、GO_PRIVATE等环境变量已生效，否则go build可能拉不到私有模块
多人同时编辑冲突或权限失控
默认设置下，Code With Me 允许最多 5 人同时输入（typing），超出后新加入者会被提示 “Wait for someone to stop typing”。但更隐蔽的问题是权限粒度太粗：一旦 Host 选了 “Full access”，Guest 就能打开终端、执行 go run、甚至删掉 go.mod——这在团队教学或 Code Review 场景中极危险。
建议始终用 Custom 权限模式，明确关闭 “Terminal” 和 “Run/Debug Configurations” 两项。仅保留 “Edit files” 和 “View project structure” 即可满足绝大多数协作需求。
- Host 误点 “Force All to Follow You” 后，Guest 编辑器会强制跳转到 Host 当前光标位置，失去自主导航能力；这个开关在顶部菜单栏
Code With Me → Force Others to Follow You，关掉即可恢复 - Guest 修改文件后，Host 不会自动 reload —— 需要 Host 主动
Ctrl+Shift+O（Reload project）才能让 GoLand 识别新 import 或类型变化 - 如果 Host 本地开了
git status自动刷新，Guest 看到的 Git 工具窗口状态可能滞后 2–3 秒，不要据此判断文件是否已提交
go.work 文件、甚至 ~/.zshrc 里的 alias，全部不会同步给 Guest。Guest 看到的只是 Host IDE 渲染出的 UI 快照，不是另一个可独立运行的 Go 开发环境。
