goland 测试后残留 docker 容器源于测试代码显式调用 docker 命令或 testcontainers-go 未调用 terminate，需在 run configuration 中配置 post-run shell 脚本精准清理，go clean -testcache 对容器无效。

GoLand 里跑完测试还留着 Docker 容器？先确认是否真由测试启动

GoLand 默认不会自动启停容器，残留容器大概率来自测试代码里显式调用 docker run、exec.Command("docker", "run") 或第三方库（如 testcontainers-go）。直接在 GoLand 的 “Run” 面板点 Stop 并不能杀掉这些子进程。必须区分：是 GoLand 启动的测试进程本身被终止，还是它 spawn 的容器也被清理。

• 检查测试代码里是否有 defer exec.Command("docker", "rm", "-f", cid).Run() 这类手动清理逻辑
• 若用了 testcontainers-go，确认是否调用了 container.Terminate(ctx) —— 它默认不自动清理，得显式调用
• 运行 docker ps -a --format "{{.ID}}\t{{.Status}}\t{{.Names}}" | grep test，看容器名是否含 test、tmp 或时间戳，这是典型测试生成的命名模式

在 GoLand 的 Run Configuration 里加 post-run 清理脚本

GoLand 支持在测试执行后自动运行 Shell 命令，这是最可控、不侵入业务代码的清理方式。关键不是“删所有”，而是精准匹配当前测试会话产生的容器。

GoLand 2026.1.1

GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。

下载

• 打开 Run → Edit Configurations → 找到你的测试配置 → 展开 “After launch”
• 勾选 “Run external tool”，点 “+” 添加新工具，类型选 “Shell script”
• 脚本内容推荐：

  docker ps -a --filter "name=test-$(date -d '1 minute ago' +'%Y%m%d')*" -q | xargs -r docker rm -f

  （Linux/macOS）；Windows 可用 PowerShell 替代，注意日期格式适配
• 避免用 docker system prune -f —— 它会清空整个构建缓存，影响其他并行开发任务
• 该脚本只删 1 分钟内创建、名字带 test- 的容器，兼顾安全与实效

为什么 go clean -testcache 对容器无效

go clean -testcache 只清理 $GOCACHE 下的测试构建产物（.test 二进制、符号表等），和 Docker 容器完全无关。很多人混淆是因为都发生在 “测试执行后”，但它们属于两个隔离层：一个是 Go 工具链的构建缓存，一个是宿主机的容器运行时。

• 执行 go clean -testcache 后 docker ps 输出不变，证明容器未被触碰
• 真正需要清理容器时，必须调用 Docker CLI 或其 API，GoLand 本身不提供容器生命周期管理能力
• 如果测试中用了 t.TempDir() 创建临时目录挂载进容器，也要注意：目录删了，容器里进程可能还在读写，得先停容器再删宿主机路径

CI 和本地环境要分开处理

GoLand 是本地 IDE，它的配置不上传 CI。CI 脚本里必须单独写容器清理逻辑，否则 PR 构建会累积僵尸容器占满磁盘。

• GitHub Actions 示例：

  - name: Cleanup test containers<br>  run: docker ps -a --filter "name=test-" -q | xargs -r docker rm -f

• GitLab CI 可加在 after_script 中，但需确保 runner 有 Docker 权限
• 本地 GoLand 配置只是辅助，不能替代 CI 的兜底清理——这点最容易被忽略