
libphonenumber 号码解析、格式化与验证从输入框到批量文本的完整实践【免费下载链接】libphonenumberGoogles common Java, C and JavaScript library for parsing, formatting, and validating international phone numbers.项目地址: https://gitcode.com/GitHub_Trending/li/libphonenumberlibphonenumber 是 Google 开源的电话号码处理库把国际电话号码的解析、格式化与验证封装成几行 API覆盖 200 国家/地区的号码规则提供 Java、C、JavaScript 三个实现。读完这篇你会知道怎么按场景选版本、用最短路径跑通解析→校验→格式化以及哪些坑值得提前避开。一分钟看懂 libphonenumber同一份号码元数据驱动三个语言实现行为基本一致所以选型只看运行环境不用担心版本间逻辑漂移。它自 Android 4.0 起被系统内置处理国际电话格式、E.164 格式、号码归属地这类需求时规则库是内置的不用自己维护正则表。实现语言适用平台核心能力元数据来源JavaAndroid、JVM 后端解析、校验、格式化、批量提取、地理编码、运营商识别编译期内置元数据文件另有 metadata/metadata.zip 供工具链重新生成C原生桌面、嵌入式、跨端客户端解析、校验、格式化、离线地理编码字节化元数据构建期从同一份元数据生成JavaScript浏览器、Node解析、校验、格式化、输入实时格式化打包进 JS 的元数据对象仓库里还有一个 Web 演示能直接在浏览器里试各种号码的解析和格式化效果。选对版本再动手三个版本的元数据同源同一号码的解析结论应当一致选型按你的运行环境走Javajava/libphonenumber/Android 端和 JVM 后端的主力选择地理编码、运营商识别等扩展模块geocoder、carrier也只挂在 Java 侧JavaScriptjavascript/i18n/phonenumbers/浏览器里做号码格式化和输入实时格式化不依赖服务端Ccpp/src/phonenumbers/原生桌面或嵌入式场景接口与 Java 版大体对应。如果你只需要在网页表单里处理号码先跑 JavaScript 版的 demo 看效果入口在 javascript/i18n/phonenumbers/demo.html再决定是否上服务端。⏱ 最短路径三步验证一个国际电话号码下面这段 Java 代码串起 parse、校验、格式化三个动作以瑞士号码 044 668 18 00 为例PhoneNumberUtil phoneUtil PhoneNumberUtil.getInstance(); Phonenumber.PhoneNumber number phoneUtil.parse(044 668 18 00, CH); System.out.println(phoneUtil.isValidNumber(number)); System.out.println(phoneUtil.format(number, PhoneNumberUtil.PhoneNumberFormat.E164)); System.out.println(phoneUtil.format(number, PhoneNumberUtil.PhoneNumberFormat.INTERNATIONAL)); System.out.println(phoneUtil.format(number, PhoneNumberUtil.PhoneNumberFormat.NATIONAL));parse产出带国家码和国内号码的结构化对象isValidNumber按元数据判断它是否真实可拨format的四种输出对应不同用途——E.164 适合做数据库唯一键INTERNATIONAL 适合展示NATIONAL 适合本地拨打。注意parse的第二参数是国家代码CLDR 双字母码不是地区名也不是猜测依据。三个落地场景电话输入框实时格式化把 AsYouTypeFormatter 实例绑在输入框上用户每敲一个数字就按当地习惯补上分隔输入时号码自动分组AsYouTypeFormatter fmt phoneUtil.getAsYouTypeFormatter(US); for (char c : 6502530000.toCharArray()) { System.out.println(fmt.inputDigit(c)); }美国号码输入到第 7 位就会自动出现 650 253 这样的分组用户体验和系统电话应用一致。从混合文本中批量提取电话号码PhoneNumberMatcher从一段非结构化文本里把号码找出来返回带原始位置的结果String text Call 1 650 253 0000 or write to supportexample.com; for (PhoneNumberMatch match : phoneUtil.findNumbers(text, US)) { System.out.println(match.rawString() match.startIndex()); }它处理好了分隔符、括号、call 这类噪声词适合客服工单、聊天记录这类数据清洗场景。多语言查询号码归属地PhoneNumberOfflineGeocoder用本地前缀映射表查询号码归属地支持多语言输出PhoneNumberOfflineGeocoder geocoder PhoneNumberOfflineGeocoder.getInstance(); System.out.println(geocoder.getDescriptionForNumber(number, Locale.ENGLISH)); // Zurich System.out.println(geocoder.getDescriptionForNumber(number, Locale.GERMAN)); // Zürich查询完全离线语言参数决定输出文本前端可以直接把Locale传进去无需额外翻译服务。Android 集成要点仓库自带的 demoapp 是一个完整的参考实现核心链路四步引入依赖本地联调可参考 demoapp 的构建配置正式项目用 Maven 发布版初始化PhoneNumberUtil.getInstance()全局复用一个实例即可用户输入变化时调用parseisValidNumber做 Android 电话号码校验捕获NumberParseException给出提示结果页按需要展示 INTERNATIONAL 或 E.164 格式关键交互代码在 MainActivity 里可以直接对照。边界与常见误区能解析成功不等于号码有效parse只要求长得像个号码isValidNumber才做真实性校验表单里两个判断要分开用没有号时必须传国家代码parse(044 668 18 00, CH)与不传地区参数的行为不同默认地区参数决定无前缀号码如何解释号码规则会变运营商分号段、新号段投放后旧版元数据可能误判升级库版本前先看 release_notes.txt地理编码是前缀级归属地精确到前缀映射的粒度通常到城市/省份级别指望定位到街道PhoneNumberUtil实例无状态线程间共享同一个getInstance()返回值是安全的别为每个请求 new 一个。写在最后元数据是这套库真正的资产规则更新节奏跟着各国电信监管走。动手前翻一眼 README.md 和 FAQ.md上线前对照 release_notes.txt 确认元数据版本基本就不会踩到规则过期的问题。【免费下载链接】libphonenumberGoogles common Java, C and JavaScript library for parsing, formatting, and validating international phone numbers.项目地址: https://gitcode.com/GitHub_Trending/li/libphonenumber创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考