net.ParseIP解析失败主因是输入非法：含空格、端口、CIDR后缀、方括号或不可见字符；需先strings.TrimSpace，再按是否含“/”分流至ParseIP或ParseCIDR。
net.ParseIP 解析失败的常见原因
直接调用 net.ParseIP 却返回 nil，大概率不是代码写错了，而是传入了非法格式或含多余空格。它只接受标准 IPv4（如 "192.168.1.1"）或 IPv6（如 "2001:db8::1"）字符串，不支持带端口、协议头、CIDR 后缀（如 "10.0.0.0/8"）或方括号包裹（如 "[::1]"）的输入。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 先用
strings.TrimSpace清除首尾空白，避免因换行或空格静默失败 - 若不确定输入是否含 CIDR，别直接喂给
net.ParseIP；先用strings.Contains检查"/"，有则走 CIDR 解析分支 - IPv6 地址若来自 URL 或日志，可能带
"["和"]"，需手动去掉再解析 -
net.ParseIP对 IPv4 和 IPv6 都返回net.IP，但底层字节数不同（4 字节 vs 16 字节），后续做比较或掩码时注意统一处理逻辑
判断 IP 是否在 CIDR 网段内：用 net.IPNet.Contains 而非手动位运算
很多人想自己写位运算比对掩码，其实 Go 标准库已封装好可靠逻辑：net.ParseCIDR 返回 *net.IPNet，其 .Contains() 方法能正确处理 IPv4/IPv6、前导零、全零地址等边界情况。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 用
_, ipNet, err := net.ParseCIDR("192.168.0.0/16")解析网段，err不为nil说明 CIDR 格式非法（如掩码超长、IP 部分无效） -
ipNet.Contains(ip)中的ip必须是net.ParseIP成功返回的非nil值，否则恒返回false - 注意：
net.IPNet的IP字段是网络地址（如"192.168.0.0"），不是原始输入字符串；不要拿它和原始字符串比较 - 性能上，
Contains是 O(1)，无需缓存或预计算；反复调用没问题
区分 ParseIP 和 ParseCIDR 的使用场景
net.ParseIP 只管“这串字符是不是合法 IP”，而 net.ParseCIDR 是“这串字符是不是合法网段，并拆出网络地址和掩码”。两者目的不同，不能混用。
常见误用：
- 把
"10.0.0.1/24"丢给net.ParseIP→ 返回nil，程序误判为非法 IP - 把纯 IP 如
"172.16.0.5"丢给net.ParseCIDR→ 返回error：“invalid CIDR address” - 没检查
net.ParseCIDR的 error，导致ipNet为nil，后续调用Containspanic
正确做法是先识别输入结构：含 "/" 就走 ParseCIDR，不含就走 ParseIP；或者统一用正则粗筛（^([0-9a-fA-F:.]+)/[0-9]+$）再分流。
IPv6 地址解析与 CIDR 判断的隐藏坑
IPv6 的压缩写法（如 "::1"、"2001:db8::"）能被 net.ParseIP 正确识别，但 net.ParseCIDR 要求掩码长度明确且合法（IPv6 掩码范围是 0–128），且网络地址部分必须是完整展开形式或能无歧义压缩的格式。
容易踩的点：
-
net.ParseCIDR("::1/128")✅ 成功；net.ParseCIDR("::/0")✅ 成功；但net.ParseCIDR("::/129")❌ 报错 -
net.ParseIP("::ffff:192.0.2.1")返回 IPv6 地址，但它是 IPv4-mapped IPv6，ip.To4()可转回 IPv4；若用于 CIDR 判断，需确认目标网段是否也按同样语义设计 - 某些日志中的 IPv6 可能带端口（
"[2001:db8::1]:8080"），必须先去掉方括号和端口再解析，否则两个函数都失败
CIDR 判断本身对 IPv4/IPv6 透明，但调试时打印 ip.String() 可能输出压缩形式，而 ipNet.IP.String() 输出的是网络地址的规范形式，二者视觉不一致不代表逻辑错误。
