格式校验宽松且不支持国际区号选择、格式化与国家码映射；intl-tel-input 专注解决国家选择、区号插入、格式化及验证全链路，需引入 utils.js、启用 separatedialcode: true，并用 iti.getnumber(e164) 获取标准化号码。
为什么直接用 <input type="tel"> 不够用
因为浏览器原生的 <input type="tel"> 只校验格式宽松（甚至不校验），完全不处理国际区号选择、格式化、国家码映射这些真实业务必需的功能。用户可能输 +86 138****1234、0086-138****1234 或纯数字 138****1234，后端根本没法统一解析。
用 intl-tel-input 是最省心的落地方案
它不是“又一个 UI 库”，而是专注解决电话输入中「国家选择 + 区号自动插入 + 格式化 + 验证」这一整条链路的成熟方案。注意三点：
- 必须引入
utils.js（单独下载，非 npm 默认包含），否则isValidNumber和格式化功能失效 -
separateDialCode: true要设为true，否则区号会混在输入框里，无法干净提取getSelectedCountryData().dialCode - 初始化后，用
iti.getNumber(intlTelInputUtils.numberFormat.E164)获取标准化号码，别直接读input.value
const input = document.querySelector("#phone");
const iti = window.intlTelInput(input, {
utilsScript: "/path/to/utils.js",
separateDialCode: true,
initialCountry: "cn",
preferredCountries: ["cn", "us", "jp"]
});
手动提取国家码和本地号码时的常见错误
很多开发者以为拿到 iti.getNumber() 就完事了，但后端通常需要拆成两字段：country_code（如 "CN"）和 national_number（如 "13812345678"）。错误做法包括：
- 用
input.value去正则匹配区号——会被用户手动删改破坏结构 - 把
iti.getSelectedCountryData().dialCode当作国家码（这是"+86"，不是"CN"） - 没调用
iti.isValidNumber()就提交，导致getNumber()返回空字符串
正确方式是：先验证，再用 iti.getSelectedCountryData().iso2 拿 ISO 国家码，用 iti.getNumber(intlTelInputUtils.numberFormat.NATIONAL) 拿不含区号的本地号（注意：该值仍含分隔符，需额外 .replace(/\D/g, "") 清洗）。
移动端键盘与光标行为的兼容性坑
在 iOS Safari 上，intl-tel-input 的下拉国家列表常被系统键盘遮挡；Android 部分机型点击区号触发两次 focus，导致光标跳到开头。关键修复点：
- 给容器加
style="z-index: 1000;"，避免被键盘盖住 - 监听
open:countrydropdown事件，手动scrollIntoView({ behavior: "smooth" })到输入框 - 禁用默认 focus 行为：在
focus事件里event.preventDefault()，改用iti.promise.then(() => input.select())控制光标
这些细节不处理，用户在手机上点选国家后输不了号码，问题直接卡在第一步。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
