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 配置对多阶段支持良好，但几个硬性约束容易被忽略：

Docker Cleanup Toolkit

Docker 资源清理、裁剪及磁盘使用分析工具包。检查容器、镜像、卷、网络、构建缓存使用情况并裁剪已停止的容器等。

下载

• 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 指令后静默失败。