net.ParseIP 返回 nil 而非 error 是因其设计为纯解析函数，仅做语法校验：非法输入（如"256.1.1.1"、空字符串、含空格/不可见字符）直接返回 nil；必须先判空再调用.To4()等方法，否则易 panic。
net.ParseIP 为什么返回 nil 而不是报错？
Go 的 net.ParseIP 不会 panic，也不会返回 error，它只返回 *net.IP（底层是字节数组切片）。输入非法格式（比如 "256.1.1.1"、"192.168.1"、空字符串）时，直接返回 nil。这是它最常被误用的点——很多人忘了判空就直接用，结果 panic。
正确做法永远先检查是否为 nil：
ip := net.ParseIP("192.168.1.256")
if ip == nil {
log.Println("无效 IP 地址")
return
}
// 此时才能安全使用 ip.String() 或 ip.To4()
- IPv4 和 IPv6 都支持，
"::1"、"2001:db8::1"都能解析成功 - 不校验地址是否“可用”（比如广播地址、保留地址），只做语法解析
- 返回值是
net.IP类型，本质是[]byte，注意别和string混用
ParseIP 解析后怎么判断是 IPv4 还是 IPv6？
不能靠字符串前缀（比如 strings.HasPrefix(ip.String(), "fe80:")），因为 ip.String() 会自动压缩 IPv6 格式，且 IPv4 映射地址（如 ::ffff:192.168.1.1）也会被识别为 IPv6。
推荐用标准方法：
立即学习“go语言免费学习笔记（深入）”；
-
ip.To4() != nil→ 是纯 IPv4（或 IPv4 映射地址中的 IPv4 部分） -
ip.To16() != nil && ip.To4() == nil→ 是纯 IPv6 -
ip.To16() == nil→ 解析失败（即ip == nil）
注意：ip.To4() 对 IPv6 返回 nil；ip.To16() 对 IPv4 返回 16 字节格式（高位补 0），所以必须配合 To4() 判断才准确。
为什么 ParseIP 解析 "127.0.0.1" 后 To4() 返回 nil？
这通常发生在你用了错误的字面量或拼接方式：比如 "127.0.0.1\n" 带换行符，或 " 127.0.0.1 " 有空格。ParseIP 不做 trim，空白字符会导致解析失败，返回 nil。
常见陷阱：
- 从文件/HTTP header 读取 IP 时没调用
strings.TrimSpace() - 用
fmt.Sscanf或正则提取后残留不可见字符（\r、\u200b等） - 误把 CIDR（如
"192.168.1.0/24"）传给ParseIP—— 它不处理掩码，得用net.ParseCIDR
调试建议：打印原始字符串的 rune 值：fmt.Printf("%q", s)，看有没有隐藏字符。
ParseIP 在高并发下性能如何？要不要缓存？
net.ParseIP 是纯内存操作，无系统调用，单次解析约 20–50ns（取决于字符串长度），比大多数正则快一个数量级。一般场景完全不需要缓存。
但要注意两点：
- 如果反复解析同一字符串（比如配置里写死的 IP），可以提前解析并存为
net.IP变量，避免重复调用 - 不要把
net.ParseIP放在热循环里解析用户输入的大量 IP——虽快，但若每秒几万次，仍可能成为瓶颈；此时可考虑预编译正则粗筛（如^[0-9]{1,3}(\.[0-9]{1,3}){3}$）再进 ParseIP
真正影响性能的往往是后续操作：比如用解析后的 IP 做 map 查找、DNS 反查、或转成字符串再比较——这些才是该优化的地方。
