Go远程调试必须用delve而非go run，因官方无内置远程调试器，go run进程无法被attach；delve作为唯一广泛支持的DAP实现，需以dlv exec/dlv dap启动并启用-debug符号（-gcflags="all=-N -l"），否则断点无效、变量优化。
Go 远程调试为什么必须用 delve 而不是 go run
Go 官方没有内置远程调试器，go run 启动的进程无法被外部调试器 attach；delve（dlv）是唯一被广泛支持的 Go 调试协议实现，它把调试逻辑做成了独立服务，能监听 TCP 端口、接受 VS Code 或 CLI 的 DAP 请求。
常见错误现象：could not launch process: fork/exec /path/to/binary: no such file or directory —— 这通常是因为容器里没装 dlv，或二进制路径写错；还有人试图用 go run main.go 加 -gcflags 启动，结果 dlv 根本连不上，因为没启用调试符号或没走 dlv 启动流程。
- 必须用
dlv exec或dlv dap启动程序，不能绕过 dlv 直接跑二进制 - 编译时加
-gcflags="all=-N -l"是必须的，否则断点无效（优化会内联/删掉变量） - 容器内运行
dlv时，要确保工作目录、源码路径、二进制路径三者一致，否则 VS Code 找不到对应源文件
Docker 容器里启动 dlv dap 的关键参数
dlv dap 是当前最稳的远程调试模式，尤其适配 VS Code 的 Go 插件；但它默认只监听 localhost，容器里必须显式绑定到 0.0.0.0，否则宿主机连不上。
容易踩的坑：dlv dap --listen=:2345 看似正确，但容器网络里这等价于 --listen=127.0.0.1:2345，导致端口映射后仍连接拒绝；还有人漏掉 --headless=true，结果 dlv 卡在交互式终端等待输入。
立即学习“go语言免费学习笔记（深入）”；
使用 Python 脚本下载 Docker 镜像并打包为 tar 文件。用户说“下载镜像”“拉取镜像”“pull xxx”“帮我下载 nginx 镜像”等时触发。支持 SOCKS5 代理直连（推荐）和国内镜像站加速两种模式。
- 完整启动命令：
dlv dap --headless=true --listen=0.0.0.0:2345 --log=true --api-version=2 -
--api-version=2必须指定，新版 VS Code Go 插件不兼容 v1 - 容器启动时加
--security-opt seccomp=unconfined（Linux）或关掉 Docker Desktop 的 gRPC-FUSE 隔离（macOS），否则dlv可能因 ptrace 权限失败
VS Code launch.json 怎么配才不连丢
配置错一个字段，VS Code 就报 Failed to launch: could not find Delve debugger 或 connection refused；核心问题不在插件，而在 port、host、mode 和源码映射是否对得上。
典型场景：本地写代码，Docker 容器跑 dlv，宿主机 VS Code 连过去——这时 host 填 localhost 是对的（Docker for Mac/Windows 的端口映射走 host.docker.internal 不必要），但 sourceMap 必须把容器内路径映射回本地路径。
-
"mode": "attach"，不是launch（后者会尝试自己启进程） -
"port": 2345要和容器--listen端口一致，且docker run -p 2345:2345已暴露 -
"sourceMap": { "/app": "${workspaceFolder}" }—— 前者是容器里dlv看到的路径，后者是本地打开的工程路径
调试时变量显示 optimized away 怎么办
这不是环境问题，是编译器优化导致的；即使加了 -gcflags，如果构建命令写成 go build -gcflags="all=-N -l" .，而实际运行的是另一个没加 flag 的二进制，或者用了 CGO_ENABLED=0 但忘了重新 build，就会看到变量全灰、断点跳过、栈帧空。
性能影响其实很小：关闭优化仅让二进制大 10–20%，执行慢不到 5%，但换来的是可调试性；线上绝对不要这么跑，但开发/测试镜像里必须固化这个构建逻辑。
- 确认你 attach 的二进制，确实是用
go build -gcflags="all=-N -l"编出来的 - 检查容器里
ls -l二进制时间戳，和本地 build 时间是否一致 - 在容器里执行
go tool compile -S main.go | grep -A5 "TEXT.*main.main"，看有没有NOFRAME或内联提示，有就说明优化没关干净
真正麻烦的是跨平台构建：比如 macOS 本地 build 的二进制扔进 Linux 容器跑，delve 会因调试信息格式不兼容直接 panic。必须在目标平台环境里 build + dlv。
