使用 libphonenumber 的 IsValidNumber 判断号码格式是否合法，Parse 仅解析语法，需配合 IsValidNumber 才能验证位数、号段等规则；输入前须 TrimSpace 清理空白和隐藏字符，region 为空时需带 + 前缀。
用 libphonenumber 解析并验证号码格式是否合法
Go 原生标准库不提供国际电话号码验证能力，必须依赖第三方库。目前最可靠、被广泛采用的是 Google 官方维护的 libphonenumber 的 Go 移植版：github.com/nyaruka/phonenumbers（注意不是已归档的 github.com/ttacon/libphonenumber）。它完整支持 E.164 标准、国家代码推断、格式化和合法性校验。
安装命令：go get github.com/nyaruka/phonenumbers
- 验证前必须指定或能推断出国家代码（
region），否则Parse会失败或返回模糊结果 -
Parse只做基础语法解析，不保证号码真实存在；要判断“是否合法格式”，需后续调用IsValidNumber - 输入字符串不能含多余空格或不可见字符（如
\u200e），建议先用strings.TrimSpace清理
为什么 Parse 成功不代表号码合法
Parse 只检查字符串能否被拆解为国家码 + 号码段，不验证位数、号段规则或运营商分配逻辑。比如中国手机号 "13812345678" 在未指定 "CN" 时可能被误判为美国号码（因以 1 开头），而 "123456789" 即使指定 "CN" 也会通过 Parse（长度不足但语法上“可解析”），但 IsValidNumber 会返回 false。
- 务必在
Parse后调用phonenumbers.IsValidNumber(num)—— 这才是判断“合法格式”的核心步骤 - 若不确定国家，可用
phonenumbers.ParseAndKeepRawInput+phonenumbers.GetRegionCodeForNumber尝试推断，但推断失败时仍需 fallback 到默认 region - 对用户输入的带
+的号码（如"+86 138-1234-5678"），Parse能自动识别国家码，此时region参数可传空字符串""
常见错误：把 IsPossibleNumber 当作合法性判断
IsPossibleNumber 仅检查号码长度是否在该国家合理范围内（例如中国手机号必须是 11 位），但它不校验号段、前缀或网络分配规则。很多无效号（如 "12345678901"）会通过 IsPossibleNumber，但被 IsValidNumber 拒绝。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
- 生产环境必须用
IsValidNumber，不要降级为IsPossibleNumber - 若需快速过滤明显错误（如长度为 3 的字符串），可先用
IsPossibleNumber做轻量预筛，但最终判定以IsValidNumber为准 - 注意：某些小国家或新号段可能未被
libphonenumber数据库覆盖，IsValidNumber可能误判，此时需结合业务场景容忍或人工审核
实际验证函数写法示例
以下是一个健壮的校验函数，处理了常见边界情况：
func IsValidInternationalPhone(phone, region string) bool {
// 清理空白符
phone = strings.TrimSpace(phone)
if phone == "" {
return false
}
num, err := phonenumbers.Parse(phone, region)
if err != nil {
return false
}
return phonenumbers.IsValidNumber(num)
}
调用示例：IsValidInternationalPhone("+8613812345678", "") 或 IsValidInternationalPhone("021-1234-5678", "CN")。注意区域码传空字符串时，要求输入含 + 前缀；否则必须显式传入 ISO 3166-1 alpha-2 码（如 "US"、"JP"）。
真正麻烦的地方不在代码本身，而在用户输入的多样性：带括号、中文全角符号、隐藏 Unicode 字符、甚至混用多种分隔符。光靠正则无法覆盖，必须依赖 libphonenumber 的解析逻辑，且清理步骤不能省略。
