必须在Settings → Languages & Frameworks → Go → Go SDK中点击…→Add SDK→Docker Compose配置，填入正确路径与服务名，并确保docker-compose.yml含healthcheck及dlv调试支持。
GoLand里怎么配Docker Compose解释器
GoLand本身不运行docker-compose.yml，它只是把你的服务定义“当作远程解释器”来用——本质是让Go代码在容器里跑，同时把IDE的调试、运行、测试等功能桥接到容器进程。配置成功后，你点绿色三角就能直接启动docker compose up，而不是手动敲命令。
关键不是“能不能配”，而是配错位置就完全不生效：必须在 Settings → Languages & Frameworks → Go → Go SDK 页面里，点击右侧的 ... 按钮，选择 Add SDK → Docker Compose，不是在 Run Configuration 里随便选个服务就完事。
- 配置前确保系统已安装
docker compose（v2 插件形式，非旧版docker-compose单独二进制） -
docker-compose.yml路径要填绝对路径或项目相对路径（如./docker-compose.yml），不能是~/project/docker-compose.yml - 服务名必须和
services:下一级的 key 完全一致，比如api:就填api，多一个空格或大小写错误都会导致找不到容器 - GoLand会自动挂载当前项目目录到容器内对应路径，但如果你的
Dockerfile或go.mod依赖了外部路径（如../shared），得手动在volumes里补上
为什么点了Run还是报“connection refused”或“no such service”
这不是GoLand的问题，而是depends_on被当真了。YAML里写 depends_on: [db] 只保证容器启动顺序，不等postgres真正监听5432端口——Go服务一启动就去连，大概率失败。
真正有效的做法是：在Go服务里加重试逻辑，或在docker-compose.yml里给依赖服务加healthcheck，再配合restart: on-failure。GoLand调用docker compose up时不会帮你等健康状态，它只管把容器拉起来。
- 数据库服务务必加
healthcheck，例如 PostgreSQL：healthcheck: test: ["CMD-SHELL", "pg_isready -U postgres"] interval: 30s timeout: 10s retries: 5
- Go服务的
main.go里别用time.Sleep(5 * time.Second)硬等，改用net.DialTimeout循环探测db:5432是否可连 - GoLand的Run Configuration里勾选
Include services defined in docker-compose.yml才会真正触发up，否则它只尝试连接已存在的容器
如何让GoLand调试容器里的Go程序
调试的前提是容器里有dlv（Delve）并暴露调试端口，且GoLand能反向连进去。默认的golang:alpine镜像不含dlv，也不开2345端口，直接配解释器是没法断点的。
你需要改两处：Dockerfile里装dlv并用--headless模式启动；docker-compose.yml里把调试端口映射出来，并加security_opt允许ptrace（Linux必需）。
- Dockerfile末尾换成：
RUN go install github.com/go-delve/delve/cmd/dlv@latest CMD ["dlv", "--headless", "--api-version=2", "--addr=:2345", "--log", "--continue", "--accept-multiclient", "--only-same-user=false", "--allow-non-terminal-interactive=true", "--listen=0.0.0.0:2345", "exec", "./main"]
- docker-compose.yml中对应服务加：
ports: - "2345:2345" security_opt: - "seccomp:unconfined" cap_add: - SYS_PTRACE
- GoLand里Run Configuration选
Go Remote，Host填localhost，Port填2345，不要选“Docker Compose”类型——后者只支持运行，不支持调试
多个Go服务共用一个docker-compose.yml时怎么单独启停
GoLand不支持“只启api不启worker”这种细粒度控制。它调用的是docker compose up -d，默认启动所有服务。想单独操作，得绕过IDE，用终端手动执行命令。
但你可以用profiles变通：在docker-compose.yml里用profiles字段标记服务用途，然后在GoLand的Run Configuration里指定--profile参数（需自定义命令）。
- 先在
docker-compose.yml里给服务加profiles：api: profiles: ["dev", "full"] build: ./api worker: profiles: ["full"] build: ./worker
- GoLand里新建一个
Run Configuration → Templates → Docker Compose，在Command line options填：--profile dev up -d api - 注意：这个命令实际执行的是
docker compose --profile dev up -d api，GoLand只是透传，不解析profiles语义 - 如果服务间有
depends_on，哪怕只启api，它依赖的db也会被一起拉起——这是Compose行为，不是IDE问题
GoLand对Docker Compose的支持始终停留在“调用CLI + 挂载代码 + 映射端口”这一层，它不会解析YAML里的环境变量注入、不会处理build.args动态替换、也不会帮你做健康等待。真正复杂的依赖协调和启动策略，还是得靠docker compose自身的机制，IDE只是个触发器。
