client.NewClientWithOpts 必须显式指定连接方式推荐使用 client.FromEnv client.WithAPIVersionNegotiation()ImagePull 需消费全部响应流ContainerCreate 返回仅含 ID 字符串Start 时须传完整 IDContainerLogs 需处理 header 并设 Follow: false。client.NewClientWithOpts 必须显式指定连接方式不设 WithHost 或 FromEnv 就连不上 daemon——这不是代码 bug是 SDK 默认不猜你的环境。怎么让 client.NewClientWithOpts 连上本地 Docker daemonGo 的 Docker SDK 不会自动读取 /var/run/docker.sock也不默认信任 DOCKER_HOST 环境变量必须明确告诉它怎么连。开发机用 Unix socket传 client.WithHost(unix:///var/run/docker.sock)Linux/macOS 要确认当前用户在 docker 组里否则报 permission deniedWSL2 用户同样用 unix:///var/run/docker.sock但得在 Docker Desktop 设置里打开 “WSL integration”否则 socket 文件根本不存在别硬写 tcp://localhost:2375Docker 默认不开放 TCP 端口开它要改 daemon.json、重启服务还带安全风险最省心的初始化写法client.NewClientWithOpts(client.FromEnv, client.WithAPIVersionNegotiation())它会读 DOCKER_HOST 和 DOCKER_API_VERSION适合 CI/CD 或多环境部署ImagePull 卡住或返回空镜像其实是没读完流cli.ImagePull 返回的是 io.ReadCloser不是“拉完了就返回”。不消费全部内容连接就挂起后续所有调用比如 ContainerCreate都会卡死。只写 defer resp.Close() 是错的——关闭句柄不等于读完数据静默拉取用 io.Copy(io.Discard, resp)简单可靠要显示进度用 json.NewDecoder(resp) 循环 Decode检查 event[status] 是否为 Download complete 或 Already exists拉私有仓库必须加 client.WithCredentialsStore否则直接 401没配的话ImagePullOptions{All: true} 也救不了ContainerCreate 后 ContainerStart 报 “no such container”常见误解以为 ContainerCreateResponse 是个容器对象其实它只有 ID 字符串字段。传错类型、截断 ID、或漏掉 ctx 都会导致失败。 幻导航网 发现优质实用网站,开启网络探索之旅