端口被占用导致 dlv bind socket failed，应先用 lsof 或 netstat 查进程，再换端口（如 :2346）或加 --accept-multiclient 启动，VS Code 需同步修改 launch.json 的 port 和配置。
dlv debug 时提示 bind socket failed 是端口被占了
这个错误几乎总是因为 dlv 默认尝试监听 localhost:2345，但该端口已被另一个 dlv 进程、IDE（如 VS Code 的 Go 扩展）、或残留的调试会话占用了。
别急着杀进程，先确认谁在用：
- macOS / Linux：运行
lsof -i :2345或sudo lsof -iTCP:2345 -sTCP:LISTEN - Windows：运行
netstat -ano | findstr :2345，再用tasklist | findstr <PID>查进程名
常见干扰源：dlv dap 后台服务、VS Code 断开调试后没清理的 dlv、或者上一次 dlv debug 没正常退出留下的僵尸监听。
换端口启动 dlv 就能绕过冲突
不硬刚占用，直接指定空闲端口最稳妥。所有 dlv 子命令都支持 --headless --listen 参数：
立即学习“go语言免费学习笔记（深入）”；
dlv debug --headless --listen :2346 --api-version 2dlv test --headless --listen :2347 --api-version 2 ./...- 如果用 VS Code，改
.vscode/launch.json里的"port"字段，比如设为2346
注意：--api-version 2 是必须的（新版 dlv 默认用 v2），否则 IDE 可能连不上；端口号记得加冒号前缀 :2346，漏掉会报语法错。
GoLand 或 VS Code 调试失败时，检查 dlv 是否启用了 --accept-multiclient
IDE 多次重启调试时，有时会尝试复用已有 dlv 实例。但默认 dlv 只接受单次连接，第二次连就会卡住或报 bind 错误。
- 手动启动时加
--accept-multiclient：dlv debug --headless --listen :2345 --api-version 2 --accept-multiclient - VS Code 中需在
launch.json加"dlvLoadConfig": { "followPointers": true }并确保"mode"是debug，否则该 flag 不生效 - GoLand 用户在
Run → Edit Configurations → Go Tool Arguments里追加--accept-multiclient
不加这个参数，IDE 点两次“调试”大概率触发 bind socket failed —— 因为第一次连接后 dlv 没退出，第二次又试图 bind 同一地址。
dlv 用 root 启动后普通用户无法再 bind 同端口
如果曾用 sudo dlv debug，系统可能把 localhost:2345 绑定到了 SO_REUSEADDR 但没释放干净，导致非 root 用户后续启动失败，错误里还可能夹带 permission denied。
- 立刻执行
sudo lsof -i :2345查看是否还有 root 权限的dlv进程 - 杀掉它：
sudo kill -9 <PID> - 避免再用
sudo dlv：除非真要调试需要 root 权限的 syscall，否则纯 Go 应用完全不需要
这个坑特别隐蔽：你没主动 sudo，但某次用 GoLand 点了“以管理员身份运行”，或者终端之前切过 root，就可能埋下伏笔。
真正麻烦的不是端口冲突本身，而是多个调试工具（IDE、命令行、CI 脚本）共用一套 dlv 配置，又没统一管理生命周期。一个 --accept-multiclient 漏了，或者一个 dlv dap 没关干净，下次调试就卡在这儿。
