GoLand不支持保存即构建的自动镜像生成，需手动配置Dockerfile运行项并勾选“Build image before run”；关键包括指定正确Dockerfile路径、设置小写镜像名、配置端口映射及多阶段构建中显式声明CGO_ENABLED=0和GOPROXY。
GoLand 本身不提供“一键自动构建镜像”的后台监听机制，所谓“自动”，实际是配置好 dockerfile 运行配置后，每次点击运行按钮时触发 docker build —— 它不会在你保存 Dockerfile 或代码时悄悄构建，也不会热重载。这是常见误解的源头。
在 GoLand 中添加 Dockerfile 运行配置
这是真正让 GoLand “构建镜像 + 启动容器”联动的关键步骤，不是靠插件开关或设置项自动生效的。
- 打开 Run → Edit Configurations…（或用快捷键
Ctrl+Alt+Shift+S→ 左侧选Templates → Docker → Dockerfile） - 点击左上角
+，选择Dockerfile -
Dockerfile路径：必须指向项目根目录下的Dockerfile文件（不能是相对路径如./Dockerfile，GoLand 会报 “File not found”） -
Image tag：填你要生成的镜像名，例如myapp:dev；注意必须全小写、不能含下划线，否则docker build会失败 -
Container name：可选，但建议填，比如myapp-dev，方便后续docker ps识别 - 端口映射：
Host port和Container port填一致（如都填8080），否则服务跑起来也访问不到
为什么改了代码却没进新镜像？
因为 GoLand 的 Dockerfile 配置默认不开启 “Build image before run”。它只负责执行 docker run，而镜像可能还是上次构建的旧版本。
- 必须手动勾选配置里的
Build image before run（在配置窗口右上区域，常被忽略） - 如果 Dockerfile 使用
COPY . .，确保当前工作目录是项目根目录——GoLand 构建上下文默认就是 Run 配置所在目录，不是 GOPATH 或模块路径 - 多阶段构建中，若
go build命令没加CGO_ENABLED=0 GOOS=linux，编译出的二进制在scratch或alpine镜像里直接报no such file or directory（其实是动态链接器缺失）
常见错误：failed to solve: failed to compute cache key
这通常出现在 GoLand 调用 docker build 时，上下文路径或 .dockerignore 导致构建失败，而非 Docker daemon 连接问题。
- 检查
.dockerignore是否误删了go.mod或main.go—— 忽略它们会导致go mod tidy或go build报错 - 确认 GoLand 设置里 Docker 连接地址正确：
Settings → Build → Docker，本地 Docker Desktop 默认是unix:///var/run/docker.sock（Linux/macOS）或tcp://127.0.0.1:2375（Windows WSL2 需额外启用 TCP） - 如果用了
golang:alpine做 builder，go mod download可能因 ca-certificates 缺失而超时，需在 RUN 前加RUN apk add --no-cache ca-certificates
最易被忽略的一点：GoLand 的 Docker 插件不会帮你处理 GOPROXY 或 go env 配置。所有 go mod 相关命令都运行在容器内，所以代理必须显式写进 Dockerfile，比如 RUN go env -w GOPROXY=https://goproxy.cn,direct，而不是依赖宿主机的环境变量。
