GoLand中需配置Dockerfile运行配置并勾选Rebuild image before run，设置正确Image tag、Dockerfile绝对路径及Context directory为项目根目录，才能实现一键构建镜像；多阶段构建须确保AS阶段名一致、COPY使用绝对路径，且最终阶段环境变量匹配。
GoLand 本身不提供“全自动构建镜像”的后台守护流程，但可以通过配置 Dockerfile 运行配置 + 正确设置构建上下文，实现一键触发 docker build 并可选地自动运行容器——这是最贴近用户期望的“自动构建流程”。
怎么在 GoLand 里创建一个能真正 build 镜像的运行配置
关键不是点“运行”就完事，而是得让 GoLand 知道你想要它执行的是 Docker 构建动作，而不是启动 Go 程序。
- 打开
Run | Edit Configurations…（或点击右上角下拉菜单旁的 ⚙️） - 点击左上角
+→ 选择Dockerfile -
Image tag必须填，比如myapp:dev；空值会导致构建失败且无提示 -
Dockerfile路径要指向项目根目录下的Dockerfile，不能是相对路径如./Dockerfile，GoLand 会报Cannot resolve file 'Dockerfile' -
Context directory建议设为项目根目录（即.），否则COPY . .类指令会找不到文件
为什么改了代码后点运行不重新 build 镜像
因为默认配置下，GoLand 只会在首次运行时构建镜像；后续运行复用已有镜像，不会触发 docker build —— 它把“构建”当成一次性前置动作，而非每次运行都执行的步骤。
- 解决办法：勾选配置里的
Rebuild image before run（在Before launch区域下方） - 如果不勾选，即使你改了
Dockerfile或源码，docker run启动的仍是旧镜像 - 注意：勾选后每次运行都会执行完整构建，没有增量缓存跳过逻辑，纯靠 Docker 自身 layer 缓存提速
多阶段构建时常见失败点
GoLand 的 Dockerfile 配置对多阶段支持良好，但几个硬性约束容易被忽略：
-
FROM golang:1.24 AS builder中的AS builder必须写全，漏掉AS或名字不一致，会导致COPY --from=builder报错invalid from flag value - 如果构建阶段用了
CGO_ENABLED=0 GOOS=linux，但最终镜像用的是scratch或alpine，而你又没加ENV CGO_ENABLED=0到最终阶段，go run类命令会直接失败（但go build出的二进制不受影响） -
COPY --from=builder /app/main /app/这类跨阶段复制，目标路径必须是绝对路径；写成COPY --from=builder app/main .会静默失败，容器启动时报exec: "/app/main": stat /app/main: no such file or directory
构建成功但容器起不来？先看日志输出位置
GoLand 默认把 docker build 和 docker run 的输出混在同一个控制台，错误信息容易被滚动刷走。
- 构建失败时，重点看最后一段是否含
failed to solve、executor failed running或具体命令退出码（如exit code: 2） - 容器启动失败，别只盯着 “Container started”，要展开控制台里带
[docker]前缀的那行，里面才有docker: Error response from daemon: … - 如果用了
EXPOSE但没配-p映射，服务监听了端口但宿主机访问不到——这不是构建问题，是运行配置里Port mappings没填
真正的难点不在“怎么点”，而在“点之前是否理解构建上下文、阶段命名、COPY 路径和镜像 tag 的耦合关系”。一旦某处路径写错或 stage 名拼错，GoLand 不会高亮提示，只会让构建卡在某个 RUN 指令后静默失败。
