GoLand 本身不运行 Docker 容器，它通过“Go Remote”配置 + 容器内 dlv 调试服务实现远程调试；真正运行和构建必须靠 docker run 或 docker-compose up 启动容器，GoLand 只负责代码编辑、上传、断点控制和变量查看。
直接说结论：GoLand 本身不运行 Docker 容器，它通过“Go Remote”配置 + 容器内 dlv 调试服务实现远程调试；真正运行和构建必须靠 docker run 或 docker-compose up 启动容器，GoLand 只负责代码编辑、上传、断点控制和变量查看。
Go Remote 配置必须填对这四个字段
GoLand → Run → Edit Configurations → Go Remote：
-
Host填localhost（不是容器 IP，也不是127.0.0.1—— macOS/Windows 下 Docker Desktop 的端口映射只认localhost） -
Port填容器暴露的dlv端口（默认2345），必须和docker run -p 2345:2345一致 -
Working directory填你本地项目根路径（如/Users/you/myapp），不是容器里的/app -
Program填相对路径./main.go或./cmd/server/main.go，GoLand 会自动上传并触发容器内dlv加载
容器启动前必须确认三件事
否则 GoLand 连接时会报 Connection refused 或断点灰色不可用：
- 容器内
dlv已启动且监听0.0.0.0:2345（不能是127.0.0.1:2345），命令类似：dlv debug --headless --listen=:2345 --api-version=2 --accept-multiclient -
docker run必须带-p 2345:2345，且加--network=host（仅限 Linux）或确保端口映射生效（macOS/Windows 依赖 Docker Desktop） - 源码挂载路径与容器
WORKDIR严格一致：Dockerfile 写了WORKDIR /app，docker run就得用-v $(pwd):/app；挂错位置会导致go mod找不到go.mod、dlv加载失败、断点失效
Mac/Windows 用户最容易忽略的挂载路径限制
Docker Desktop 默认只共享 /Users（macOS）或 C:\Users（Windows）下的子目录。如果你把项目放在 /opt/myapp 或 D:\projects\myapp：
立即学习“go语言免费学习笔记（深入）”；
-
docker run -v /opt/myapp:/app实际挂载为空 —— 容器里ls /app什么也没有 - 解决方法：把项目移到
/Users/you/myapp，或在 Docker Desktop 设置中手动添加共享路径（Settings → Resources → File Sharing） - 验证方式：进容器执行
ls -l /app，看文件是否真实存在；再执行go list -m，确认模块能正常解析
调试时 go.work 或 replace 失效怎么办
本地 go.work 文件或 go.mod 中的 replace 指向绝对路径（如 replace example.com/foo => /Users/you/foo），在容器里必然失败：
- 全部改用相对路径：
replace example.com/foo => ../foo - 或者在容器内重新
go work use ../foo（需确保挂载了对应目录） - 更稳妥的做法：开发阶段不用
replace，改用go mod edit -replace生成临时修改，调试完再go mod tidy撤销
最常被跳过的检查项是挂载路径与 WORKDIR 对齐 —— 它不报错，但会让所有调试功能静默失效。每次改完 Dockerfile 或 docker run 参数后，先进容器 pwd && ls 确认当前目录和文件结构，比反复重启 GoLand 有效得多。
