iPad Safari 导入 vCard 仅完整支持 3.0 版本，需用大写字段、TYPE 参数声明类型，URL 必须带协议，ADR 要按固定顺序分号分隔，推荐 data URL 触发原生导入以减少丢项。
iPad 的 HTML5 名片导入（vCard）默认只识别标准字段，像 ORG、TITLE、NOTE 这些常见项能正常写入，但 URL、IMPP（即时通讯）、ADR（多地址行）、TEL 的类型标注（如 WORK / MOBILE）经常被 Safari 忽略或合并丢失——这不是你代码写错了，是 iOS 系统级限制，但有绕过路径。
确认 Safari 实际支持的 vCard 版本和字段
iPad（iOS 16+）的 Contacts.app 通过 Safari 打开 .vcf 文件时，仅完整解析 vCard 3.0；vCard 4.0 中的 IMPP、URL（非 URL: 开头的单行值）、GENDER 等字段会被静默丢弃。必须降级为 VERSION:3.0，且所有字段用大写 + 冒号分隔。
-
FN、N、TEL、EMAIL、ORG、TITLE、NOTE是安全字段，可带参数（如TEL;TYPE=WORK） -
URL字段必须写成URL:http://example.com（不能省略协议），且只能有一个；多个 URL 需合并进NOTE -
ADR必须扁平化为单行，用分号分隔：例如ADR;TYPE=WORK:;;北京市朝阳区;国贸大厦B座;28层;;100020;北京市;;（顺序固定：POBOX;EXTADD;STREET;LOCALITY;REGION;PCODE;CTRY;TZONE;ADR
补漏关键：用 TYPE 参数显式声明字段用途
iPad 不识别 TEL 后面的中文注释或空格分隔，只认 RFC 2426 定义的 TYPE 参数。漏项常因写了 TEL:138-0013-8000 (手机) —— 括号内容被 Safari 当作无效字符跳过。
- 正确写法：
TEL;TYPE=MOBILE;TYPE=PERSONAL:138-0013-8000（支持多个TYPE） -
EMAIL同理：EMAIL;TYPE=WORK:dev@example.com - 避免使用
HOME/WORK以外的自定义类型（如OTHER），iOS 会忽略整条记录 - 若需存微信 ID，只能塞进
NOTE或用URL伪装：URL:weixin://contacts/yourid（不触发跳转，但至少保留字符串）
绕过 Safari 解析缺陷：改用 data URL 触发原生导入
直接链接 经常触发下载而非导入；而用 data: URL 可强制调起通讯录 UI，且解析更严格、漏项更少。
立即学习“前端免费学习笔记（深入）”；
const vcard = `BEGIN:VCARD
VERSION:3.0
FN:张三
N:张;三;;;
TEL;TYPE=MOBILE:138-0013-8000
TEL;TYPE=WORK:010-88889999
EMAIL;TYPE=WORK:zhang@example.com
URL:http://zhang.example.com
NOTE:微信ID: zhang_123\\nGitHub: github.com/zhang
END:VCARD`;
const blob = new Blob([vcard], { type: 'text/vcard' });
const url = URL.createObjectURL(blob);
const a = document.createElement('a');
a.href = url;
a.download = 'contact.vcf';
a.click();
URL.revokeObjectURL(url);
注意：URL.createObjectURL() 在 iOS 上兼容性稳定；但 data: URL 超过 ~20KB 可能失败，此时必须用真实 .vcf 文件 + ，并确保服务器返回 Content-Type: text/vcard。
最易被忽略的是 ADR 的字段顺序和空段占位——少一个分号或错位，整行地址就变成纯文本塞进「备注」里。别信预览效果，每次改完都真机测试导入后打开联系人详情页，逐项核对「工作」、「家庭」标签是否正确归属。
