本文讲解如何通过结构体嵌入（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: %s\n", 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 惯用法的网络地址抽象。
