不能直接 attach，GoLand 依赖 dlv 调试容器内 Go 进程，需在容器内以 dlv exec --headless --listen=:2345 启动程序并映射端口，GoLand 通过 localhost:2345 远程连接，且必须确保二进制含调试符号（-gcflags="all=-N -l"）、权限（SYS_PTRACE）、路径映射一致。
GoLand 能否直接 attach 到容器内 Go 进程？
不能直接 attach，GoLand 本身不提供原生的 Docker 容器内进程 attach 调试能力。它依赖 dlv（Delve）作为调试器，而 Delve 必须在目标进程中以 debug 模式启动（或通过 dlv attach 接入正在运行的进程），但前提是该进程由同一台宿主机上的 dlv 可见——Docker 容器默认是隔离的，且 GoLand 运行在宿主机上，无法直接看到容器内进程的内存/ptrace 权限。
必须让 Delve 在容器内运行并暴露调试端口
核心思路是：在容器内启动 Go 程序时，用 dlv 替代 go run，并开启远程调试服务（--headless --api-version=2 --accept-multiclient --continue --listen=:2345）。GoLand 再通过 TCP 连接该端口。
- 确保容器镜像中已安装
dlv（推荐 Alpine 镜像用apk add delve，或基于golang镜像在构建阶段go install github.com/go-delve/delve/cmd/dlv@latest） - Docker 启动时必须映射调试端口：
-p 2345:2345，且容器网络不能是host以外的模式（如bridge是默认且可用的） - Go 程序启动命令要换成：
dlv exec ./your-binary --headless --api-version=2 --accept-multiclient --continue --listen=:2345 - 若用
docker-compose.yml，需加security_opt: ["seccomp:unconfined"]（Linux）和cap_add: ["SYS_PTRACE"]，否则dlv无法注入
GoLand 配置 Remote Debug 的关键参数
在 GoLand 中新建 “Go Remote” 调试配置，不是 “Go Build and Run”：
Docker Image Puller
下载
使用 Python 脚本下载 Docker 镜像并打包为 tar 文件。用户说“下载镜像”“拉取镜像”“pull xxx”“帮我下载 nginx 镜像”等时触发。支持 SOCKS5 代理直连（推荐）和国内镜像站加速两种模式。
-
Host填localhost（不是容器 IP；Docker 端口映射后，宿主机 localhost:2345 就是容器 :2345） -
Port填2345（与容器内dlv --listen端口一致） -
Working directory必须设为宿主机上对应源码路径（GoLand 靠它匹配断点位置，和容器内路径无关） - 不要勾选
Allow connections from network clients（除非你明确需要跨机器调试；本地调试不需要） - 如果提示 “Failed to find module root”，检查
go.mod是否在所设 working directory 下，且 GoLand 已正确识别 Go modules
常见失败现象和绕不过去的坑
最常卡在连接成功但断点不命中，或根本连不上：
- 容器内
dlv启动后日志没输出API server listening at: [::]:2345→ 检查cap_add和security_opt是否生效（docker inspect查CapAdd和SecurityOpt字段） - GoLand 提示
Connection refused→ 宿主机telnet localhost 2345不通，说明端口没映射对，或容器内dlv没监听0.0.0.0:2345（注意--listen=:2345中的:表示绑定所有接口，不是127.0.0.1:2345） - 断点灰掉、提示 “No executable code found” → 宿主机源码路径与容器内编译路径不一致（例如容器里
go build -o /app/main .，但宿主机路径是/Users/xxx/project），GoLand 无法关联；此时可在dlv启动时加--wd /path/in/container，并在 GoLand 的 working directory 设为对应宿主机路径 - 调试时变量显示
<optimized out></optimized>→ 编译时用了-ldflags="-s -w"或go build -gcflags="all=-l"，必须去掉这些 flag，保留调试信息
真正麻烦的是路径映射和符号表一致性——容器内外的文件系统是割裂的，Delve 依赖宿主机的源码位置做断点解析，这点没法绕开，只能靠人工对齐。
