唯一正解是用net.parsecidr解析cidr得*net.ipnet，再调用contains判断ip归属；需预解析缓存、校验输入、处理ipv4-mapped ipv6等边界情况，禁用手算掩码或字符串匹配。
如何用 net.ParseIP 和 net.IPNet 判断 IP 是否在指定网段内
Go 标准库的 net 包已经提供了可靠的 CIDR 解析能力，不需要自己拆点分、算掩码。关键在于：必须用 net.ParseCIDR（而非 net.ParseIP 单独解析）来获取 *net.IPNet，否则无法正确处理掩码边界。
常见错误是先 ParseIP 再手动构造 IPNet，结果因 IPv4/IPv6 地址长度不一致、掩码位数未对齐导致匹配失败。比如 "192.168.1.0/24" 解析后，IPNet.Contains 才能正确识别 "192.168.1.100"。
-
net.ParseCIDR("10.0.0.0/8")返回*net.IPNet，可直接调用.Contains() - 传入的 IP 必须是
net.ParseIP()结果，且注意：IPv4 地址在底层可能以 IPv6 形式（如::ffff:192.168.1.1）存在，Contains内部已兼容，无需手动转换 - 若 CIDR 字符串格式错误（如
"192.168.1.0/33"），ParseCIDR返回 error，必须检查
支持多个 CIDR 规则时，怎样避免重复解析和 panic
如果过滤规则来自配置文件或 HTTP 参数，每次请求都调用 net.ParseCIDR 会浪费 CPU；更危险的是，未校验输入就直接传给 ParseCIDR，遇到非法字符串（如 "192.168.1.0/xx"）会导致 panic 或静默失败。
推荐做法是在初始化阶段预解析所有规则，并缓存 []*net.IPNet。运行时只做 Contains 判断，零分配、无 error 检查开销。
- 定义结构体字段为
rules []*net.IPNet，而非[]string - 解析入口统一用
func ParseRules(rules []string) ([]*net.IPNet, error)，内部对每个字符串调用net.ParseCIDR并收集 error - 空规则或单条非法规则应整体返回 error，避免部分加载——否则后续
Contains可能漏匹配
如何扩展支持非 CIDR 的自定义规则（如 IP 范围、通配符）
标准 net.IPNet 只支持 CIDR，但业务常需 "192.168.1.10-192.168.1.50" 或 "10.*.*.*" 这类表达。不能硬塞进 ParseCIDR，得单独实现匹配逻辑，且必须和 CIDR 规则共存。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
建议用 interface 统一抽象：
type IPMatcher interface {
Match(ip net.IP) bool
}
然后为不同规则类型实现：
- CIDRMatcher：包装
*net.IPNet，调用ipnet.Contains(ip) - RangeMatcher：用
net.ParseIP解析起止 IP，转为uint32（IPv4）或[16]byte（IPv6）比较大小 - WildcardMatcher：将
"10.*.*.*"转成正则^10\.\d+\.\d+\.\d+$，但注意性能——正则编译一次、复用*regexp.Regexp
实际使用时，遍历 []IPMatcher，任一返回 true 即判定命中。
为什么 net.ParseIP("127.0.0.1 ").TrimSpace() 会出错
看似微小的空格、换行符会让 net.ParseIP 返回 nil，而 nil IP 传给 Contains 会 panic：“panic: runtime error: invalid memory address”。这不是 Go 的 bug，是使用者没做输入清洗。
- 所有外部输入（HTTP header、query、config file）必须先
strings.TrimSpace - 不要依赖
ParseIP自动忽略空白——它严格按 RFC 与字节流匹配 - 调试时可加日志：
log.Printf("raw ip: %q, parsed: %v", raw, net.ParseIP(raw))，快速定位空格问题
最易被忽略的是 YAML/JSON 配置里换行缩进产生的不可见字符，以及前端表单提交时用户手误多敲的空格。这类问题不会报错，但会让整条规则失效。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
