Go 函数支持多返回值，但调用时必须接收全部返回值（或用 _ 忽略部分），无法“只返回一个值”；若需忽略某返回值，应在调用处用下划线 _ 显式丢弃，而非在函数内部省略。
go 函数支持多返回值，但调用时必须接收全部返回值（或用 `_` 忽略部分），无法“只返回一个值”；若需忽略某返回值，应在调用处用下划线 `_` 显式丢弃，而非在函数内部省略。
在 Go 中，函数的返回签名是严格定义的——例如 func() ([]docker.Container, string) 表示该函数必须始终返回两个值：一个 []docker.Container 类型切片和一个 string 类型（通常用于错误信息）。你不能在函数体内只写 return err.Error() 或 return _（语法错误），因为 _ 是变量名，不能作为返回值占位符；它仅用于接收时忽略。
✅ 正确做法是：
- 错误发生时，返回零值（如 nil 切片） + 错误字符串；
- 成功时，返回实际数据 + nil 字符串（或空字符串，但更推荐统一用 error 类型）。
不过，当前签名 ([]docker.Container, string) 并非 Go 最佳实践。标准惯用法应使用 error 类型作为第二个返回值：
func GetContainersRunningImage(imagename, tag string) ([]docker.Container, error) {
logFields := log.Fields{"handler": "get service"}
client, err := docker.NewTLSClient(
sconf.DockConf.Endpoint,
sconf.DockConf.Cert,
sconf.DockConf.Key,
sconf.DockConf.Ca,
)
if err != nil {
log.WithFields(logFields).Errorf("TLSClient could not be created: %v", err)
return nil, err // ✅ 返回 nil 切片 + error
}
// 后续逻辑：获取容器列表（假设为 containers）
var containers []docker.Container
// ... 实际调用 client.ListContainers 等操作
return containers, nil // ✅ 返回数据 + nil error
}? 调用时，可选择性忽略某个返回值：
containers, err := GetContainersRunningImage("nginx", "latest")
if err != nil {
log.Fatal(err)
}
// 此时 containers 已可用，err 已被处理
// 若只需错误信息，可忽略容器结果：
_, err := GetContainersRunningImage("redis", "alpine")
if err != nil {
log.Printf("Failed to list redis containers: %v", err)
}⚠️ 注意事项：
- Go 不允许返回值类型与声明签名不匹配（如少返、类型错、用 _ 代替值）；
- nil 对切片、map、指针、接口、channel、函数等类型是合法零值，但对 string、int 等基础类型需用对应零值（"", 0）；
- 强烈建议将第二个返回值设为 error 而非 string，以便与标准库一致，并支持 errors.Is/errors.As 等错误处理机制；
- 若坚持用 string 作错误载体，请确保调用方明确区分空字符串（成功）与非空字符串（失败），但这违背 Go 通用约定。
总结：不是“如何只返回一个值”，而是“如何正确返回所有声明的值”——用零值（nil, "", 0 等）填充无需使用的返回位置，并在调用侧用 _ 忽略不需要的变量。这才是 Go 多返回值设计的本意与最佳实践。
