是，net.ParseIP 对非法字符串（如 "256.1.1.1"、空字符串、含不可见字符等）返回 nil，这是判断 IP 合法性的核心依据；它不支持 CIDR 和域名（如 "localhost"），需先判 nil 再操作。
net.ParseIP 会返回 nil 吗？什么时候返回 nil
会，而且这是判断 IP 合法性的核心依据。net.ParseIP 对非法字符串（比如 "256.1.1.1"、"192.168.1"、"::1::"）直接返回 nil，不抛 panic，也不区分 IPv4/IPv6 —— 它只管“能不能解析成一个有效的 IP 地址”。
常见错误现象：
- 把 net.ParseIP 当作“校验函数”用，但没检查返回值是否为 nil，导致后续调用 .To4() 或 .IsGlobalUnicast() 时 panic
- 误以为 "127.0.0.1" 和 "::1" 解析后类型相同，其实返回的是 *net.IP，底层是 []byte，长度不同（IPv4 是 4 字节，IPv6 是 16 字节）
- 永远先判
ip != nil再做后续操作 -
net.ParseIP支持 CIDR 吗？不支持。传入"192.168.1.0/24"会返回nil；需用net.ParseCIDR - 空字符串、全空格、含不可见字符（如
"192.168.1.1\u200b"）也会返回nil，建议提前strings.TrimSpace
怎么区分 IPv4 和 IPv6？不要用字符串匹配
别用 strings.Contains(ipStr, ":") 或正则去猜 —— "::1" 是 IPv6，"127.0.0.1" 是 IPv4，但 "192.168.1.1:8080" 是带端口的 URL 片段，不是 IP。
正确做法：用 ip.To4() 和 ip.To16() 判断
-
ip.To4() != nil→ 是 IPv4（或可映射为 IPv4 的 IPv6 地址，如::ffff:192.168.1.1） -
ip.To16() != nil && ip.To4() == nil→ 是纯 IPv6（排除 IPv4-mapped） -
ip.To16() == nil→ 解析失败或非法格式（但此时ip已为nil，这步不会执行）
注意：ip.To16() 对 IPv4 地址也返回非-nil（补零扩展为 16 字节），所以必须配合 To4() 一起用才能准确分类。
立即学习“go语言免费学习笔记（深入）”；
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
net.ParseIP 能识别 localhost、127.0.0.1/::1 这类地址吗
能解析 "127.0.0.1" 和 "::1"，但不能解析 "localhost" —— net.ParseIP 只处理字面 IP 表示，不查 DNS、不读 hosts 文件。
常见错误场景：
- 用户输入框允许填域名或 IP，后端只调 net.ParseIP，结果 "localhost" 被判为非法
- 混淆了「地址解析」和「名称解析」：需要域名支持，得用 net.LookupIP，但它可能返回多个 IP，且有网络 I/O 和超时风险
- 若业务只要支持字面量 IP，就坚持用
net.ParseIP+nil判定 - 若必须支持
"localhost"，应单独白名单处理：if strings.EqualFold(s, "localhost") { return true } - 别在服务启动时缓存
net.LookupIP("localhost")结果，因为容器环境里它可能指向不同地址（如127.0.0.11）
IPv4-mapped IPv6 地址容易被忽略的兼容性问题
像 ::ffff:192.168.1.1 这种格式，是 IPv4 地址在 IPv6 协议栈里的表示方式。net.ParseIP 能正确解析它，但 ip.To4() 会返回对应的 IPv4 地址（192.168.1.1），而 ip.To16() 返回完整 16 字节。
坑点在于：很多网络库或中间件（比如某些 HTTP 代理、ACL 规则引擎）把这类地址当成 IPv6 处理，但你的代码如果只按 To4() != nil 就认为是 IPv4，可能导致策略错配。
- 生产环境做 IP 白名单时，明确决定是否接受 IPv4-mapped：若接受，用
ip.To4() != nil；若拒绝，加额外判断!ip.IsUnspecified() && ip.To4() == nil && len(ip) == net.IPv6len -
net.ParseIP("::ffff:256.1.1.1")会返回nil（因为嵌入的 IPv4 部分非法），这点常被忽略 - 日志打印 IP 时，用
ip.String()会自动压缩（如::ffff:c0a8:101），不利于排查；调试建议用fmt.Printf("%x", ip)
IP 版本判断看着简单，但混合部署、Docker 网络、云厂商 SLB 回源地址这些场景下，IPv4-mapped 和双栈配置才是实际踩坑最多的地方。
