本文讲解如何通过结构体嵌入（embedding）而非类型别名的方式，为 net.ip 构建支持 json 反序列化、内置方法继承和安全拷贝的自定义类型 ipaddr。
在 go 中，类型别名（如 type IPAddr net.IP）不会继承原类型的任何方法，也无法直接使用其底层操作（如 len()、copy() 或 To4()），因为 Go 严格区分类型系统与方法集——方法只属于定义它的具体类型，且不跨类型传递。此外，标准库的 json.Unmarshal 也仅识别 net.IP 类型，对别名类型默认无解码支持。
要真正复用 net.IP 的全部能力并拓展自定义逻辑，应采用 结构体嵌入（embedding） 方式：
type IPAddr Struct { net.IP }该写法使 IPAddr 自动获得 net.IP 的所有导出方法（如 To4(), To16(), String(), IsLoopback() 等），同时保留作为独立类型参与接口实现、字段声明和 JSON 编解码的能力。
✅ 正确实现示例（含 JSON 支持与安全拷贝）
package main import ( "encoding/json" "fmt" "net" "log" ) type IPAddr struct { net.IP } // 实现 json.Unmarshaler 接口，支持从字符串（如 "10.100.19.1"）反序列化 func (ip *IPAddr) UnmarshalJSON(data []byte) error { // 去除引号 s := string(data) if len(s) >= 2 && s[0] == '"' && s[len(s)-1] == '"' { s = s[1 : len(s)-1] } parsed := net.ParseIP(s) if parsed == nil { return fmt.Errorf("invalid IP address: %s", s) } ip.IP = parsed return nil } // 实现 json.Marshaler 接口（可选），确保序列化为带引号的字符串 func (ip IPAddr) MarshalJSON() ([]byte, error) { if ip.IP == nil { return []byte("null"), nil } return json.Marshal(ip.IP.String()) } // 安全拷贝方法：返回新分配的 IPAddr 实例，避免共享底层字节 func (ip IPAddr) Copy() IPAddr { if ip.IP == nil { return IPAddr{} } b := make([]byte, len(ip.IP)) copy(b, ip.IP) return IPAddr{net.IP(b)} } type Network struct { CIDR string `json:"cidr"` Gateway IPAddr `json:"gateway"` } func readNetworks(data []byte) ([]Network, error) { var networks []Network if err := json.Unmarshal(data, &networks); err != nil { return nil, err } return networks, nil } func main() { data := []byte(`[{"cidr":"10.100.19.0/24","gateway":"10.100.19.1"}]`) networks, err := readNetworks(data) if err != nil { log.Fatal(err) } for _, n := range networks { fmt.Printf("CIDR: %s, Gateway: %s (IPv4? %t)n", n.CIDR, n.Gateway.String(), n.Gateway.To4() != nil, // ✅ 方法可用！ ) // 拷贝网关 IP（避免意外修改原始数据） copied := n.Gateway.Copy() fmt.Printf("Copied gateway: %sn", copied.String()) } }
⚠️ 注意事项
- 勿用类型别名扩展方法：type IPAddr net.IP 是零开销类型别名，但完全隔离方法集，无法调用 To4()，也不能被 json 包识别。
- 嵌入即继承：struct { net.IP } 让 IPAddr 自动拥有 net.IP 的所有导出方法，且 len(ip.IP) 和 copy(dst, ip.IP) 等底层操作自然生效。
- JSON 支持需手动实现：嵌入后仍需实现 UnmarshalJSON / MarshalJSON 才能处理字符串格式的 IP；否则会因类型不匹配解码失败。
- 值语义 vs 指针语义：Copy() 方法返回值类型更安全（避免外部修改底层切片）；若需修改原实例，可定义 (*IPAddr).Set(…) 方法。
通过嵌入 + 接口实现，你既能无缝复用标准库能力，又能构建类型安全、可维护、符合 Go 惯用法的网络地址抽象。