空接口能装任何值，但代价是你要自己判断
Go 里 interface{} 是一个很特别的类型。因为它没有要求任何方法，所以所有类型都实现了它。字符串、整数、结构体、切片、指针，都可以赋给 interface{}。这让它很灵活，也很容易被滥用。
灵活的代价是类型信息变弱。函数接收 interface{} 后，编译器无法帮你确认调用者传的到底是不是你想要的类型。你通常需要类型断言或 type switch 在运行时判断。如果判断错了，可能 panic，或者产生难查的逻辑错误。
这篇文章不把 interface{} 当成神奇容器，而是讲清楚它适合的场景：日志、通用打印、JSON 未知结构、框架扩展点。普通业务代码里，能用明确类型和小接口，就不要先用空接口。
最小示例
func PrintValue(v interface{}) {
fmt.Printf("%v\n", v)
}
调用：
PrintValue("hello")
PrintValue(123)
PrintValue(User{Name: "小林"})
这很适合通用打印，因为打印函数本来就不关心具体类型。
但是如果你写：
func SendMessage(to interface{}, message interface{}) error {
}
就不清楚了。to 应该是邮箱字符串，还是用户 ID，还是手机号？message 是纯文本还是结构体？调用方不知道，函数内部也只能猜。更好的签名是：
func SendMessage(to string, message string) error {
}
明确类型是 Go 可读性的基础。
类型断言
从 interface{} 取回具体类型，需要类型断言：
var v interface{} = "hello"
text, ok := v.(string)
if !ok {
fmt.Println("not a string")
return
}
fmt.Println(text)
一定要优先使用带 ok 的写法。如果写成：
text := v.(string)
当 v 不是字符串时，程序会 panic。除非你在非常明确的内部场景，否则不要省略 ok。
断言结构体：
var value interface{} = User{Name: "小林"}
user, ok := value.(User)
if !ok {
return fmt.Errorf("value must be User")
}
fmt.Println(user.Name)
如果存进去的是 *User，断言 User 不会成功。值类型和指针类型不同：
userPtr, ok := value.(*User)
这一点在反射、JSON 中间数据和上下文值里都很常见。
type switch 处理多种类型
当你确实要处理多个可能类型时，可以用 type switch：
func Describe(v interface{}) string {
switch value := v.(type) {
case string:
return "string: " + value
case int:
return fmt.Sprintf("int: %d", value)
case bool:
return fmt.Sprintf("bool: %v", value)
case nil:
return "nil"
default:
return fmt.Sprintf("unknown: %T", value)
}
}
调用：
fmt.Println(Describe("go"))
fmt.Println(Describe(42))
type switch 适合调试、日志格式化、解析未知数据等场景。普通业务分支如果大量依赖 type switch，往往说明上游类型设计太宽泛。
JSON 未知结构里的 interface
解析任意 JSON：
var value interface{}
if err := json.Unmarshal(data, &value); err != nil {
return err
}
默认映射规则大致是：
JSON object -> map[string]interface{}
JSON array -> []interface{}
JSON string -> string
JSON number -> float64
JSON bool -> bool
JSON null -> nil
例如：
obj, ok := value.(map[string]interface{})
if !ok {
return fmt.Errorf("expected object")
}
name, ok := obj["name"].(string)
if !ok {
return fmt.Errorf("name must be string")
}
这类代码很容易变啰嗦，所以如果 JSON 结构明确，优先定义结构体：
type UserRequest struct {
Name string `json:"name"`
}
interface{} 适合结构不确定的 JSON，比如第三方 Webhook 的动态 payload；结构明确时，结构体更安全。
小结
interface{} 能表示任意类型，但它会把类型检查从编译期推迟到运行期。使用它时，你通常需要类型断言或 type switch，并且要处理不匹配的情况。
适合使用 interface{} 的场景包括通用日志、调试输出、未知 JSON、框架扩展点和少量确实需要动态类型的边界。普通业务函数应该优先使用明确类型或小接口。
Go 的类型系统是帮你减少错误的，不要轻易绕开它。空接口不是万金油，而是一把需要克制使用的工具。
继续阅读
探索更多技术文章
浏览归档，发现更多关于系统设计、工具链和工程实践的内容。