GoLand连不上Docker调试端口的核心原因是dlv监听地址错误（必须0.0.0.0:2345而非127.0.0.1:2345）、宿主机端口未映射（-p 2345:2345缺失）或volume与WORKDIR路径不一致。
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
GoLand Remote Debug 的 Host 必须填 localhost
这不是直觉上的“连容器 IP”，而是因为 Docker 默认把 -p 2345:2345 映射到了宿主机的网络栈。填容器 IP（比如 172.17.0.2）反而会绕过端口映射，直接走容器内部网络——GoLand 根本访问不到。
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 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挂了
volume 挂载和 WORKDIR 必须严格一致
代码改了不生效、go mod 找不到模块、断点灰色——八成是路径错位。GoLand 编译和调试都基于本地路径，但容器运行时读的是挂载后的路径，两者必须对齐。
- Dockerfile 里设
WORKDIR /app，docker run就得用-v $(pwd):/app；如果WORKDIR是/src，挂载却到/app，go run就会在错的地方找go.mod - Mac/Windows 用户注意：
docker-desktop默认只共享/Users或C:\Users下的子目录；项目放/opt/myproj会导致挂载为空，ls /app什么也没有 - 如果用了
go.work或replace，检查路径是否为相对路径；绝对路径（如replace example.com/foo => /home/user/foo）在容器里必然失效
docker-compose.yml 要显式暴露 2345 端口并加 healthcheck
用 docker-compose 启动多服务时，光写 depends_on 不顶用——它只控制启动顺序，不等依赖服务真正就绪。数据库连不上、调试端口连不上，往往是因为 Go 服务启动太快，而 dlv 还没监听好。
-
ports段必须包含- "2345:2345"，不能只靠expose - 给数据库之类依赖服务加
healthcheck，例如 PostgreSQL：
healthcheck: test: ["CMD-SHELL", "pg_isready -U postgres"] interval: 30s timeout: 10s retries: 5
time.Sleep 硬等，改用 net.DialTimeout("tcp", "db:5432", 5*time.Second) 循环探测最容易被忽略的是：GoLand 的 Run Configuration 里必须勾选 Include services defined in docker-compose.yml，否则它不会触发 docker compose up，只会尝试连一个可能根本不存在的旧容器。
