用 docker-go 连不上本地 docker daemon 时需显式指定 host，linux 用 unix:///var/run/docker.sock，mac 用 unix:///users/$user/.docker/run/docker.sock，wsl2 用 tcp://localhost:2375 并开启 docker desktop 相应设置。
用 docker-go 连不上本地 Docker Daemon 怎么办
默认连不上，因为 Go SDK 不自动读取 DOCKER_HOST 环境变量，也不默认走 Unix socket。
- 检查 Docker daemon 是否运行：
systemctl is-active docker（Linux）或docker info（手动验证） - 初始化 client 时显式传 socket 路径：
client, err := client.NewClientWithOpts(client.WithHost("unix:///var/run/docker.sock")) - Mac 上 Docker Desktop 默认用
unix:///Users/$USER/.docker/run/docker.sock，不是/var/run/... - Windows WSL2 用户要注意：Docker Desktop 的 socket 在 Windows 主机上，WSL2 中需用
tcp://localhost:2375并开启 Docker Desktop 的 “Expose daemon on tcp://localhost:2375” 设置（不推荐生产启用）
ContainerList 返回空但 docker ps 有容器
常见于过滤条件没设对，或者 context 超时太短导致请求被截断。
- 默认
ContainerList只返回运行中容器，加client.ContainerList(ctx, types.ContainerListOptions{All: true})才能看到已退出的 - context 超时至少设 5 秒：
ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)，否则高负载下容易返回空切片且无错误 - 别漏掉
defer cancel()，否则可能泄漏 goroutine - 如果只想要名字和状态，直接取
container.Names和container.Status字段，别依赖container.Image——它只是镜像名，不含 tag
调用 ContainerCreate 失败报 “No such image” 却明明 docker images 里有
SDK 不会自动拉取镜像，也不解析 latest 标签背后的 digest，出错就是真找不到。
- 先用
ImageList检查镜像是否存在：client.ImageList(ctx, types.ImageListOptions{All: true})，遍历RepoTags字段确认完整名称（如nginx:alpine，不是只有nginx） - 手动拉取再创建：
client.ImagePull(ctx, "nginx:alpine", types.ImagePullOptions{})，注意这个函数返回的是 io.ReadCloser，要读完才真正完成拉取 - 避免用
latest：它在不同机器上可能指向不同版本，CI 或多环境部署时极易出问题 -
ContainerCreate的Config.Image字段必须是 pull 后存在的完整镜像引用，不能带 registry 前缀除非你配置了自定义 daemon
脚本跑一次就卡住，ContainerStart 后没反应
Go 的 Docker SDK 默认不阻塞，但如果你期望容器“运行完就退出”，得自己处理 attach + wait，否则主 goroutine 早结束了，容器却还在后台跑。
立即学习“go语言免费学习笔记（深入）”；
- 启动后立刻
client.ContainerAttach并设置types.ContainerAttachOptions{Stream: true, Stdout: true, Stderr: true}，否则日志看不到 - 用
client.ContainerWait阻塞等待退出：waitResp, err := client.ContainerWait(ctx, containerID, container.WaitConditionNotRunning) - 别忘了
defer client.ContainerRemove(...)清理，否则反复运行脚本会堆积 stopped 容器 - 如果容器是 long-running（比如 nginx），脚本不该等它退出；这时候你要用信号控制（
ContainerKill）或监听进程生命周期，而不是靠Wait
