GoLand连不上Docker容器调试端口的核心原因是dlv监听地址错误、端口未映射或路径挂载错位；必须确保dlv监听0.0.0.0:2345、Docker暴露-p 2345:2345、GoLand Remote Debug中Host填localhost且Working directory与容器WORKDIR及volume挂载路径严格一致。
GoLand 连不上 Docker 容器调试端口，不是配置漏了，而是 dlv 没监听对地址、端口没映射通、或路径挂载错位——三者缺一不可。
dlv 必须监听 0.0.0.0:2345，不能是 127.0.0.1:2345
容器内 127.0.0.1 只对容器自己有效，GoLand 在宿主机上连不进去。哪怕你用 docker exec -it xxx sh 进去确认 netstat -tuln | grep 2345 有监听，只要它是 127.0.0.1:2345，就注定失败。
dlv 启动命令里必须写 --listen=:2345（冒号前空着），等价于 0.0.0.0:2345；写成 --listen=127.0.0.1:2345 或 --listen=localhost:2345 都不行。
- Dockerfile 中确保装了
dlv：RUN go install github.com/go-delve/delve/cmd/dlv@latest - 启动容器时别用
go run main.go，改用：dlv --headless --listen=:2345 --api-version=2 --accept-multiclient exec ./main - Mac/Windows 用户注意：
docker-desktop默认只共享/Users或C:\Users下的子目录；项目放/opt/myproj会导致挂载为空，ls /app什么也没有
GoLand Remote Debug 的 Host 必须填 localhost
这不是直觉上的“连容器 IP”，而是因为 Docker 默认把 -p 2345:2345 映射到了宿主机的网络栈。填容器 IP（比如 172.17.0.2）反而会绕过端口映射，直接走容器内部网络——GoLand 根本访问不到。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
在 GoLand 中：Run → Edit Configurations → Go Remote：
- Host 填 localhost
- Port 填 2345
- Working directory 填你本地项目根路径（如 /Users/you/project），不是容器里的 /app
- 如果报
Connection refused，先在宿主机跑telnet localhost 2345或nc -zv localhost 2345看通不通；不通就说明容器没起来、端口没暴露、或dlv挂了 - GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者
volume 挂载和 WORKDIR 必须严格一致
代码改了不生效、go mod 找不到模块、断点灰色——八成是路径错位。GoLand 编译和调试都基于本地路径，但容器运行时读的是挂载后的路径，两者必须对齐。
- Dockerfile 里设
WORKDIR /app，docker run就得用-v $(pwd):/app；如果WORKDIR是/src，挂载却到/app，go run就会在错的地方找go.mod - 如果用了
go.work或replace，检查路径是否为相对路径；绝对路径（如/home/user/project）在容器里根本不存在 - Windows 用户若用 WSL2 开发，请勿在 GoLand 中直接调试 WSL2 内的进程；应统一走 Docker Desktop 容器方案，避免路径语义错乱
最常被忽略的其实是路径一致性——WORKDIR、volume 目标路径、GoLand 的 Working directory、以及 dlv 启动时当前工作目录，这四个值必须指向同一逻辑位置，否则断点永远灰，go list 永远失败，而错误提示往往只显示 “no debug info” 或 “could not find package”。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
