电话号码格式化校验

要解决的具体问题

手动校验手机号时，很多人会用简单的 ^1\d{10}$ 正则，但这种方案只能匹配国内 11 位号码，无法处理国际号码、带空格或区号的输入，也不能输出统一的存储格式。实际业务中，存库需要 E.164 这类无空格的标准格式，界面展示却要保留国内用户熟悉的分段样式，混用会导致数据重复或查询失败。另外，非法号码的报错往往模糊，用户不知道具体哪里填错了。

技能如何工作

该技能基于 libphonenumber-js 实现，核心能力包括：

• 校验与格式化：输入号码时自动识别默认国家（CN，可配置），合法号码返回 e164（存储用）和 national（展示用）两种格式，非法号码给出中文原因（如"位数不足""区号无效"）。
• 推荐实现步骤：失焦或提交时调用 formatPhone 函数；校验成功后写入 mobileE164 字段作为唯一标识，界面展示 national 格式；自测用例覆盖 13800138000、+86 138 0013 8000 和非法短号，确保边界情况正确。

适用边界与注意点

• 格式合法≠真实有效：校验通过仅代表格式符合规则，不保证号码已实名或可接通。
• 禁止外传号码：默认本地校验，不要将号码发送到不明外网服务。
• 避免能力冒充：不要用简单正则伪装成完整校验能力，需明确说明依赖 libphonenumber-js 的局限性。