vCard 二维码格式详解:字段、版本与完整示例
QR Cake Team发布于:
vCard 名片二维码里到底存了什么:逐行解读文本格式,手机能识别哪些字段,vCard 3.0、4.0 与 MECARD 有何区别,以及为什么联系人信息太长会让二维码难以扫码识别。
vCard 二维码是一种以 vCard 格式存储联系人的二维码:数据是纯文本,以 BEGIN:VCARD 开头,每行一项信息,以 END:VCARD 结尾。手机相机读到这段文本时,会识别出这是一个联系人,并提示添加到通讯录。.vcf 文件里存的也是完全相同的格式。
本文逐行讲解这种格式,告诉你该用哪个版本、能存多少数据,以及什么时候更适合让 vCard 名片二维码生成器只存一个短链接,而不是直接存入原始的联系人数据。
下面是一个完整、有效的联系人。每行是一个属性:字段名、冒号和值。
这种格式靠三条规则维系:
一个联系人可以包含几十种属性,但手机通讯录 App 能稳定读取的是下面这些:
电话号码请用带国家代码的国际格式,比如美国是 +1,这样保存下来的联系人在任何地方都能正确拨号。
这种格式还有 PHOTO 字段,但在二维码里放照片并不现实。嵌入的图片动辄几万个字符,而一个二维码最多只能存 2953 字节的数据。静态二维码里不要放照片,或者改用托管的电子名片,在页面上显示照片。
目前流通的格式有三个版本:
除非有特别的理由,否则请使用 3.0,并把文本保存为 UTF-8,这样带重音符号的名字或中文等非拉丁文字的名字在扫码后才不会出错。
MECARD 是 NTT DOCOMO 为日本手机上的二维码设计的一种更短的联系人格式。它把整个联系人放在一行里:
由于字符更少,二维码的密度更低,缩小尺寸后也更容易扫码。代价是字段更少:MECARD 没有存放公司名称和职位的字段,而且各扫码应用对它的支持差异比 vCard 更大。只有当二维码必须做得很小,并且姓名、电话和邮箱就已足够时,才选择它。
一个二维码最多能存 2953 字节,但这是最大、最密的那个版本的上限,不是目标。每多加一个字符,图案就更复杂:模块更多,在同样的印刷尺寸下,每个模块就更小。
上面的示例联系人有 247 个字符。在中等纠错级别下,它需要一个 61 个模块宽的图案,所以在名片上印成 2.5 厘米宽时,每个模块只有约 0.4 毫米。一个 22 个字符的短链接只需要 25 个模块,同样的尺寸下每个模块有 1 毫米。正是更大的模块,让二维码在光线昏暗、纸张有纹理或手机较旧时也能被快速识别。
要让静态 vCard 二维码保持易读:
把联系人放到二维码背后,有两种方式。
静态 vCard 二维码把 vCard 文本直接写进图案里。它不需要联网,也不依赖任何服务,永不过期。但它也无法更改:换了电话号码,就得换新码、重新印刷。
动态 vCard 二维码存的是一个短链接。扫码会打开一个带「保存联系人」按钮的电子名片页面,点这个按钮就会下载 .vcf 文件。由于信息保存在服务器上,印刷后仍可编辑,图案也能保持简洁,页面上还可以显示照片和更多链接。
如果名片要发好几年,或者是大批量印刷的物料,动态二维码更稳妥。动态二维码与静态二维码一文更全面地分析了两者的取舍,名片二维码指南则介绍了二维码在名片上的尺寸和摆放位置。
你不需要手动输入这种格式。vCard 二维码制作工具会根据你填写的表单自动生成:
保存到 QR Cake 的 vCard 二维码是动态的。图案里存的是短链接,扫码会打开你托管的电子名片,点「保存联系人」会下载标准的 vCard 3.0 文件。免费套餐最多包含 5 个动态二维码,扫描次数不限,保存的二维码永不过期。免费套餐下,名片打开之前会先显示一个简短的广告页,付费套餐会去掉它。
想知道现有的二维码里存了什么,扫一下,看手机给出什么提示。如果显示联系人预览,并提供添加到通讯录的选项,说明 vCard 文本就在图案里,这是静态二维码。如果显示的是网址,说明这是动态二维码。你也可以把二维码的照片或截图上传到二维码识别工具,它会显示解码后的内容。
vCard 二维码就是一段纯文本格式的联系人:BEGIN:VCARD、一行 VERSION、每行一个字段、END:VCARD。使用 3.0 版,只保留必要字段,并把文本保存为 UTF-8。如果信息可能会变,或者二维码必须做得很小,就用动态 vCard 二维码(也就是活码):它存的是短链接,联系人信息放在一个你可以随时编辑的页面上。
本文逐行讲解这种格式,告诉你该用哪个版本、能存多少数据,以及什么时候更适合让 vCard 名片二维码生成器只存一个短链接,而不是直接存入原始的联系人数据。
二维码里的 vCard 格式长什么样
下面是一个完整、有效的联系人。每行是一个属性:字段名、冒号和值。
BEGIN:VCARD
VERSION:3.0
N:Rivera;Alex;;;
FN:Alex Rivera
ORG:Example Studio
TITLE:Account Manager
TEL;TYPE=CELL:+12025550123
EMAIL:[email protected]
URL:https://example.com
ADR;TYPE=WORK:;;100 Main Street;Springfield;IL;62701;USA
END:VCARD这种格式靠三条规则维系:
- 名片以 BEGIN:VCARD 开头、以 END:VCARD 结尾,VERSION 行紧跟在第一行之后。
- 每个属性单独占一行。结构化的值(比如姓名或地址的各个部分)用分号分隔。
- 如果文本本身含有逗号、分号或反斜杠,要在它前面加一个反斜杠,所以“Smith, Jones and Co”要写成“Smith\, Jones and Co”。
手机能识别的 vCard 字段
一个联系人可以包含几十种属性,但手机通讯录 App 能稳定读取的是下面这些:
| 字段 | 存放内容 | 示例 |
|---|---|---|
| FN | 用于显示的完整姓名。必填。 | FN:Alex Rivera |
| N | 分段的姓名:姓、名、中间名、前缀、后缀。3.0 版必填。 | N:Rivera;Alex;;; |
| ORG | 公司或组织 | ORG:Example Studio |
| TITLE | 职位 | TITLE:Account Manager |
| TEL | 电话号码。用 TYPE 标明是 CELL(手机)、WORK(工作)还是 HOME(住宅)。 | TEL;TYPE=CELL:+12025550123 |
| 电子邮箱地址 | EMAIL:[email protected] | |
| URL | 网站 | URL:https://example.com |
| ADR | 通讯地址,分七个部分:邮政信箱、房间号、街道、城市、州或地区、邮政编码、国家。 | ADR;TYPE=WORK:;;100 Main Street;Springfield;IL;62701;USA |
| NOTE | 自由填写的备注 | NOTE:在展会上认识 |
电话号码请用带国家代码的国际格式,比如美国是 +1,这样保存下来的联系人在任何地方都能正确拨号。
这种格式还有 PHOTO 字段,但在二维码里放照片并不现实。嵌入的图片动辄几万个字符,而一个二维码最多只能存 2953 字节的数据。静态二维码里不要放照片,或者改用托管的电子名片,在页面上显示照片。
vCard 2.1、3.0 还是 4.0:该用哪个版本
目前流通的格式有三个版本:
- vCard 2.1(1996 年)是最早的版本。大多数手机仍能读取,但带重音符号的字符和非拉丁字符需要额外标记。
- vCard 3.0(1998 年)是大多数二维码生成器采用的版本,也是二维码最稳妥的选择。iPhone 和 Android 手机的相机都能可靠地识别它。
- vCard 4.0(2011 年)是当前标准,由 RFC 6350 定义。它始终使用 UTF-8,语法也更简洁,但相机应用对它的支持不够一致,有报告称部分手机会丢失字段,或无法正确显示特殊字符。
除非有特别的理由,否则请使用 3.0,并把文本保存为 UTF-8,这样带重音符号的名字或中文等非拉丁文字的名字在扫码后才不会出错。
MECARD:更紧凑的替代格式
MECARD 是 NTT DOCOMO 为日本手机上的二维码设计的一种更短的联系人格式。它把整个联系人放在一行里:
MECARD:N:Rivera,Alex;TEL:+12025550123;EMAIL:[email protected];;由于字符更少,二维码的密度更低,缩小尺寸后也更容易扫码。代价是字段更少:MECARD 没有存放公司名称和职位的字段,而且各扫码应用对它的支持差异比 vCard 更大。只有当二维码必须做得很小,并且姓名、电话和邮箱就已足够时,才选择它。
能存多少联系人数据,为什么越少越好
一个二维码最多能存 2953 字节,但这是最大、最密的那个版本的上限,不是目标。每多加一个字符,图案就更复杂:模块更多,在同样的印刷尺寸下,每个模块就更小。
上面的示例联系人有 247 个字符。在中等纠错级别下,它需要一个 61 个模块宽的图案,所以在名片上印成 2.5 厘米宽时,每个模块只有约 0.4 毫米。一个 22 个字符的短链接只需要 25 个模块,同样的尺寸下每个模块有 1 毫米。正是更大的模块,让二维码在光线昏暗、纸张有纹理或手机较旧时也能被快速识别。
要让静态 vCard 二维码保持易读:
- 只放别人联系你所需的信息:姓名、一个电话号码、一个邮箱和一个网站。
- 除非确有必要,否则不要放照片、长备注和完整的通讯地址。
- 印得比链接二维码更大一些。二维码打印尺寸指南列出了最小尺寸。
静态 vCard 二维码与动态电子名片
把联系人放到二维码背后,有两种方式。
静态 vCard 二维码把 vCard 文本直接写进图案里。它不需要联网,也不依赖任何服务,永不过期。但它也无法更改:换了电话号码,就得换新码、重新印刷。
动态 vCard 二维码存的是一个短链接。扫码会打开一个带「保存联系人」按钮的电子名片页面,点这个按钮就会下载 .vcf 文件。由于信息保存在服务器上,印刷后仍可编辑,图案也能保持简洁,页面上还可以显示照片和更多链接。
| 问题 | 静态 vCard 二维码 | 动态 vCard 二维码 |
|---|---|---|
| 图案里存的是什么 | 完整的 vCard 文本 | 一个短链接 |
| 离线可用 | 是 | 否,扫码需要联网 |
| 印刷后可编辑 | 否 | 是 |
| 图案密度 | 每加一个字段就更密 | 保持不变 |
| 照片 | 不现实 | 显示在电子名片上 |
| 依赖服务商 | 否 | 是 |
如果名片要发好几年,或者是大批量印刷的物料,动态二维码更稳妥。动态二维码与静态二维码一文更全面地分析了两者的取舍,名片二维码指南则介绍了二维码在名片上的尺寸和摆放位置。
如何制作 vCard 二维码
你不需要手动输入这种格式。vCard 二维码制作工具会根据你填写的表单自动生成:
- 打开 QR Cake vCard 名片二维码生成器。
- 填写姓名、公司、职位、电话号码、邮箱和网站。如果想在名片上展示照片和社交账号,也可以添加。
- 用你的颜色、logo 或边框设计二维码,边框上可以加一句“扫码保存我的联系方式”之类的标签。
- 用免费账号登录并保存二维码,然后下载为 PNG 或 SVG。
- 分别用 iPhone 和 Android 手机扫码,在两台手机上都点按「保存联系人」,印刷之前检查保存下来的联系人信息。
保存到 QR Cake 的 vCard 二维码是动态的。图案里存的是短链接,扫码会打开你托管的电子名片,点「保存联系人」会下载标准的 vCard 3.0 文件。免费套餐最多包含 5 个动态二维码,扫描次数不限,保存的二维码永不过期。免费套餐下,名片打开之前会先显示一个简短的广告页,付费套餐会去掉它。
如何查看 vCard 二维码里存了什么
想知道现有的二维码里存了什么,扫一下,看手机给出什么提示。如果显示联系人预览,并提供添加到通讯录的选项,说明 vCard 文本就在图案里,这是静态二维码。如果显示的是网址,说明这是动态二维码。你也可以把二维码的照片或截图上传到二维码识别工具,它会显示解码后的内容。
vCard 二维码的常见错误
- 缺少 VERSION 行或 END:VCARD 行。手机可能会把二维码当作纯文本显示,而不是识别为联系人。
- 逗号和分号没有转义。像“Smith, Jones”这样的公司名,如果逗号前面没有反斜杠,就会被拆成两个值。
- 数据太多。好几个电话号码、一段长备注再加上完整地址,会让名片上的二维码变成密密麻麻的方块,旧手机的相机根本分辨不出来。
- 嵌入照片。根本放不下。如果照片很重要,就用托管的电子名片。
- 本地格式的电话号码。不带国家代码的号码,从国外拨打就会打不通。
- 没有在两个平台上测试。iPhone 和 Android 的通讯录 App 对同样字段的排版不同,所以要在两边都检查保存下来的联系人。
一句话总结
vCard 二维码就是一段纯文本格式的联系人:BEGIN:VCARD、一行 VERSION、每行一个字段、END:VCARD。使用 3.0 版,只保留必要字段,并把文本保存为 UTF-8。如果信息可能会变,或者二维码必须做得很小,就用动态 vCard 二维码(也就是活码):它存的是短链接,联系人信息放在一个你可以随时编辑的页面上。
vCard 名片二维码生成器
vCard 名片二维码生成器:免费创建电子名片二维码(也叫联系人名片二维码),扫一次码即可显示你的照片、电话、邮箱和地址,轻点「保存联系人」就能存进手机通讯录。印刷后仍可修改信息,无需重印。
关于 QR Cake 团队
由 QR Cake 团队撰写。我们打造的 QR Cake 是一个动态二维码平台,用于可编辑的印刷活动、Canva 二维码、扫码数据分析,以及订阅结束后仍然可用的长期二维码跳转。
进一步了解 QR Cake常见问题
- vCard 二维码用的是什么格式?
- 它使用 vCard 格式,也就是 .vcf 文件里的那种纯文本。数据以 BEGIN:VCARD 开头,接着是 VERSION 行,然后每行一个属性,比如表示姓名的 FN、表示电话号码的 TEL 和表示邮箱地址的 EMAIL,最后以 END:VCARD 结尾。
- 二维码应该用哪个 vCard 版本?
- 用 vCard 3.0。它是大多数二维码生成器采用的版本,也是 iPhone 和 Android 手机相机识别最稳定的版本。vCard 4.0 是更新的标准,但相机应用对它的支持参差不齐。
- vCard 和 MECARD 有什么区别?
- MECARD 是 NTT DOCOMO 设计的一种紧凑型联系人格式,把整个联系人放在一行里。它的字符更少,所以二维码密度更低,但字段也更少,没有存放公司名称和职位的位置,而且不同扫码应用对它的支持差异更大。
- vCard 二维码能存多少信息?
- 一个二维码最多能存 2953 字节,但存得这么满的二维码在名片尺寸下太密,无法稳定识别。静态 vCard 二维码最好控制在几百个字符以内:姓名、一个电话号码、一个邮箱和一个网站。
- vCard 二维码能放照片吗?
- 静态二维码不行,嵌入的照片远远超出二维码的容量。动态 vCard 二维码可以显示照片,因为扫码打开的是托管的电子名片页面,而不是从图案里读取联系人。
- vCard 二维码印刷后还能修改吗?
- 只有动态二维码可以。静态 vCard 二维码把联系方式直接写进了图案,任何改动都需要换新码。动态 vCard 二维码存的是短链接,背后的信息可以随时编辑,二维码图案不变,无需重新印刷。
- vCard 二维码没有网络能用吗?
- 静态 vCard 二维码可以,因为手机直接从图案里读取联系人。动态 vCard 二维码需要联网,因为扫码会打开一个存有联系人的网页。
相关文章
继续阅读实用的二维码指南、案例和优化技巧。
2026年8月31日11 分钟阅读
名片二维码完全指南:尺寸、摆放位置、链接对象(2026 年版)
名片上的二维码,是所有印刷品里 ROI 最高的二维码用法。名片可以一直用到设计本身过时为止,而二维码后面的内容会随你的职业发展不断更新。
继续阅读
2026年6月1日12 分钟阅读
动态二维码与静态二维码:你究竟该用哪个?(2026 指南)
静态二维码只适合大约三种特定场景。其他情况下,动态二维码能帮你省钱、省时间,也能避免因为有人改了落地页网址、整批传单只好重印的尴尬。
继续阅读
2026年8月3日11 分钟阅读
二维码打印尺寸指南:2026 年权威参考手册
在所有失败原因中,二维码因尺寸过小而扫不出的情况最为常见。解决办法很简单:印得够大。这份指南为你梳理规则、数字,以及各类使用场景下的最小尺寸。
继续阅读