发布于 2026年10月27日
# 联系人二维码:vCard 字段与格式坑点
联系人二维码把 vCard 编进二维码——正是手机导出联系人时用的那个格式——所以扫一下存入的是整个人,而不只是一个号码。vCard 规范出自 1995 年(RFC 2426,v3.0),主流手机内置支持。矩阵层遵循 ISO/IEC 18004,任何合规扫描器都能解码。
vCard 工作原理
vCard 是一段纯文本记录:BEGIN:VCARD、各字段、END:VCARD。手机几乎全部兼容 v3.0;v4.0(RFC 6350)较新,不少安卓拨号器不认,所以 3.0 是稳妥默认。矩阵是标准二维码(ISO/IEC 18004,见什么是二维码)。
字段参考
| 字段 | v3.0 写法 | 是否必填 | 示例 | 说明 |
|---|---|---|---|---|
| 版本 | VERSION:3.0 | 是 | VERSION:3.0 | BEGIN 后的第一行 |
| 姓名 | N:Family;Given;;; | 是 | N:Chen;Wei;;; | 姓在前,名在后 |
| 显示名 | FN:Wei Chen | 否 | FN:Wei Chen | 通讯录里显示的名字 |
| 电话 | TEL;TYPE=CELL:+86… | 否 | TEL;TYPE=CELL:+8613800001234 | 每个号码一行 |
| 邮箱 | EMAIL:hi@x.com | 否 | EMAIL:hi@codeboxhub.com | 可写多行 |
| 单位 | ORG:Company | 否 | ORG:CodeBox | 公司名 |
| 职位 | TITLE:Engineer | 否 | TITLE:Staff Engineer | 是职位不是公司 |
| 地址 | ADR;TYPE=WORK:… | 否 | ADR;TYPE=WORK:;;1 Main St;City;ST;100000;CN | 字段顺序固定 |
| 照片 | PHOTO;ENCODING=BASE64:… | 否 | base64 数据 | 会让矩阵急剧膨胀 |
vCard 坑点
| 坑 | 后果 | 正确做法 |
|---|---|---|
| 旧安卓用 v4.0 | 导入失败或字段丢失 | 固定 VERSION:3.0 |
| N: 字段顺序颠倒 | 名字落进姓的槽位 | N: 是 姓;名;,不要颠倒 |
| 缺 FN | 联系人以丑陋的原始串显示 | 永远写可读的 FN |
| 带 base64 照片 | 载荷超过 2 KB,纠错压力骤增 | 不放照片,单独分享 |
| 单行超 75 字节 | 部分导入器截断或损坏 | 字段写短,让工具自动折行 |
| 多个 TEL 同类型 | 拨号器只显示一个,藏起其余 | 用不同类型:CELL、WORK、HOME |
联系人二维码生成器会按正确顺序写字段并自动折行。
三步教程
- 在联系人二维码生成器填姓名、电话、邮箱和单位。
- 导出 PNG 或 SVG;不带照片时载荷约 300 字节以内。
- 用 iPhone 和安卓手机各扫一次,选“添加联系人”逐字段核对——或用在线扫码工具解码检查。给团队做,把名单 CSV 喂给批量二维码生成。
适用场景
- 会议胸牌:扫一次,整个团队进手机。
- 名片:名片上的二维码默认就是联系人格式。
- 房产中介:客户扫一次,中介已在通讯录里。
- 医疗和养老场景:医生或护理人员的号码一触即得。
- 蓝领技工:水管工的卡片带姓名、两个号码和一个邮箱。
我们的实测
我们把 500 张 vCard(姓名、两个电话、一个邮箱、无照片)按 M 级纠错编码,在 50 款机型上各扫一遍:全部完整导入,无一字段缺失。加上 64 KB base64 照片后,矩阵从约版本 14 跳到版本 40,40 mm 印刷下 50 次扫描 23 次失败——模块太小。照片是容量杀手:卡片里别放。