本地调试与部署是两套独立流程：调试时ide直接调用go run或dlv在本地运行，部署仅复制文件到指定目录，混用易致断点失效、源码路径错乱等问题。
本地调试不需要部署
GoLand 的本地调试和“部署”是两套独立流程。调试时 IDE 直接调用 go run 或 dlv 启动进程，所有代码都在本地文件系统中运行；所谓“部署”只是将文件复制到某个目录（比如 Web 服务器根路径），它不参与调试链路。强行把“部署”和“调试”混在一起，反而容易导致断点不命中、源码路径错乱、变量无法读取等问题。
调试前必须确认的三件事
本地调试失败，80% 是卡在这三个地方：
-
GOROOT和GOPATH（或 Go Modules）配置正确 —— GoLand 会读取系统环境变量，但 Windows 上若用 WSL 或多版本 Go，建议在 Run Configuration 的 Environment variables 中显式设置GOROOT，例如GOROOT=C:\Go - 项目根目录下存在
go.mod文件且模块名合法（不能是example.com这类占位符），否则dlv无法正确解析导入路径 - 断点设在可执行语句上 —— 比如空行、
import行、函数签名行、注释行都不会触发，必须落在实际执行的代码行（如fmt.Println("hello")）
直接调试 main 包最可靠
对刚上手的项目，优先用最简路径启动调试：
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 确保当前打开的文件是
main.go，且其中包含func main() - 点击编辑器左侧边距设置断点（别点在
package main那行） - 按
Ctrl+Shift+F9（Windows/Linux）或Cmd+Shift+F9（Mac）启动调试 —— 这会自动创建一个临时Go Build配置，mode 为auto，program 指向当前目录 - 如果提示
dlv not found，GoLand 会弹窗建议安装；点链接后它会自动下载并放在~/.go/dlv（Linux/macOS）或%LOCALAPPDATA%\JetBrains\GoLandxxx\dlv（Windows）
调试 Docker 容器内 Go 程序的常见误区
很多人以为“本地部署到 Docker 就等于本地调试”，其实不然。Docker 容器是隔离环境，IDE 无法直接 attach 到其中进程，除非你主动暴露调试端口并挂载源码：
- 容器启动命令必须包含
-p 2345:2345（假设 dlv 监听 2345）和-v $(pwd):/app（把当前目录映射进容器），否则断点位置与容器内路径不匹配 - Dockerfile 中不能用
CGO_ENABLED=0编译，否则dlv无法注入调试信息 - GoLand 里要新建
Go Remote配置，Host 填localhost，Port 填2345，**不要选“Docker”类型配置**——那个只适用于镜像构建阶段，不支持 runtime attach
真正需要调试容器时，先在容器里跑 dlv --headless --listen=:2345 --api-version=2 --accept-multiclient exec ./myapp，再从 IDE attach，而不是指望“部署完就自动可调”。
