本文介绍如何使用 go 的 interface{} 实现类型安全、灵活可复用的 json 解析函数，避免为每种配置结构体重复编写解析逻辑，并指出原始代码中传值而非传指针的关键错误。
本文介绍如何使用 go 的 interface{} 实现类型安全、灵活可复用的 json 解析函数，避免为每种配置结构体重复编写解析逻辑，并指出原始代码中传值而非传指针的关键错误。
在 Go 中，若希望一个函数能处理多种结构体（如 Config、Server_Config、DatabaseConfig 等），核心思路是让函数接收任意可解码类型的地址——这正是 Go 标准库中 json.Unmarshal 所采用的设计：其第二个参数类型为 interface{}，实际要求传入指向目标值的指针（如 &config）。因此，通用解析函数应定义为：
func ParseJSON(file string, val interface{}) error {
data, err := os.ReadFile(file) // 注意：ioutil.ReadFile 已弃用，推荐使用 os.ReadFile
if err != nil {
return fmt.Errorf("failed to read %s: %w", file, err)
}
return json.Unmarshal(data, val)
}
✅ 关键点：参数 val interface{} 允许传入任意类型的指针（如 &config、&serverConf），而 json.Unmarshal 内部通过反射识别目标类型并完成填充。
下面是一个完整、可运行的示例：
// main.go
package main
import (
"encoding/json"
"fmt"
"log"
"os"
)
type ServerConfig struct {
HTMLTemplates string `json:"html_templates"` // 注意：字段需导出（大写首字母）且添加 JSON tag
}
type Config struct {
ServerConfig `json:"server_config"` // 嵌入时建议显式 tag；也可省略，取决于 JSON 结构
Port int `json:"port"`
}
func ParseJSON(file string, val interface{}) error {
data, err := os.ReadFile(file)
if err != nil {
return fmt.Errorf("failed to read %s: %w", file, err)
}
return json.Unmarshal(data, val)
}
func main() {
// 示例 1：解析 Config
var config Config
if err := ParseJSON("config.json", &config); err != nil {
log.Fatal(err)
}
fmt.Printf("Port: %d, Templates: %s\n", config.Port, config.ServerConfig.HTMLTemplates)
// 示例 2：直接解析 ServerConfig
var server ServerConfig
if err := ParseJSON("server.json", &server); err != nil {
log.Fatal(err)
}
fmt.Printf("Templates: %s\n", server.HTMLTemplates)
}
⚠️ 重要注意事项：
- 字段必须导出：Go 的 JSON 包只能访问首字母大写的导出字段（如 HTMLTemplates），html_templates（小写）将被忽略；
- 必须传指针：ParseJSON("file.json", config)（值传递）无效，因 json.Unmarshal 需修改原变量，务必用 &config；
- 错误处理应返回 error：避免直接 log.Fatal，便于调用方控制错误流（如重试、降级或记录上下文）；
- 使用 os.ReadFile：自 Go 1.16 起，ioutil.ReadFile 已弃用，应替换为 os.ReadFile；
- JSON Tag 建议显式声明：即使结构体字段名与 JSON 键一致，也推荐添加 json:"key" tag，提升可维护性与兼容性。
总结：通过将参数类型设为 interface{} 并确保传入有效指针，即可实现真正通用的 JSON 解析函数。这一模式广泛应用于 Go 生态（如 http.Post 的 body io.Reader、各类 UnmarshalXXX 函数），是掌握 Go 接口抽象与泛型前的重要实践范式。
