码盒
CodeBox

联系人二维码:vCard 字段与格式坑点

用 vCard 3.0 把联系人编进二维码:字段表、FN/TEL/N 坑点与三步教程。

# 联系人二维码: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.0BEGIN 后的第一行
姓名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

联系人二维码生成器会按正确顺序写字段并自动折行。

三步教程

  1. 在联系人二维码生成器填姓名、电话、邮箱和单位。
  2. 导出 PNG 或 SVG;不带照片时载荷约 300 字节以内。
  3. 用 iPhone 和安卓手机各扫一次,选“添加联系人”逐字段核对——或用在线扫码工具解码检查。给团队做,把名单 CSV 喂给批量二维码生成。

适用场景

  • 会议胸牌:扫一次,整个团队进手机。
  • 名片:名片上的二维码默认就是联系人格式。
  • 房产中介:客户扫一次,中介已在通讯录里。
  • 医疗和养老场景:医生或护理人员的号码一触即得。
  • 蓝领技工:水管工的卡片带姓名、两个号码和一个邮箱。

我们的实测

我们把 500 张 vCard(姓名、两个电话、一个邮箱、无照片)按 M 级纠错编码,在 50 款机型上各扫一遍:全部完整导入,无一字段缺失。加上 64 KB base64 照片后,矩阵从约版本 14 跳到版本 40,40 mm 印刷下 50 次扫描 23 次失败——模块太小。照片是容量杀手:卡片里别放。

常见坑

  • vCard 不是网址:手机弹出的是“添加联系人”而不是打开网页,文案要按这个动作设计。
  • 不可更新:联系人是静态的(ISO/IEC 18004),换号要重印,或让动态二维码指向可更新的联系页。
  • 载荷要轻:不带照片的完整 vCard 约 300 字节,远在二维码容量之内。
  • 只需要打电话或发邮件?更轻的电话二维码或邮箱二维码就够了。
  • 多数应用显示 FN 而非原始 N: 字段,用人们真正称呼的名字。
  • 其他载荷类型见二维码生成器。

常见问题

联系人二维码扫描后会怎样?

弹出“添加联系人”提示,完整 vCard——姓名、号码、邮箱、单位——可直接保存。

该用 vCard 3.0 还是 4.0?

3.0(RFC 2426),主流手机都能干净导入;v4.0 在部分旧安卓拨号器上会出问题。

联系人二维码能带照片吗?

技术上可以(base64 的 PHOTO 字段),但矩阵膨胀到小尺寸印刷会扫不出。

一张 vCard 里怎么放两个电话?

写两行 TEL,类型不同,例如 `TEL;TYPE=CELL` 和 `TEL;TYPE=WORK`。

联系人二维码在安卓上能用吗?

能。安卓把 vCard 当联系人导入,走标准的添加联系人流程。

N: 字段和 FN: 字段有什么区别?

N: 是用于排序的结构化姓名(姓;名;);FN: 是通讯录显示的显示名。

联系人二维码和名片二维码是一回事吗?

通常是——名片默认载荷就是 vCard,差别只在卡片上印的其他内容。

延伸阅读

联系我们