vCard 二维码格式详解:字段、版本与完整示例

    QR Cake Team发布于:

    vCard 名片二维码里到底存了什么:逐行解读文本格式,手机能识别哪些字段,vCard 3.0、4.0 与 MECARD 有何区别,以及为什么联系人信息太长会让二维码难以扫码识别。

    vCard 二维码是一种以 vCard 格式存储联系人的二维码:数据是纯文本,以 BEGIN:VCARD 开头,每行一项信息,以 END:VCARD 结尾。手机相机读到这段文本时,会识别出这是一个联系人,并提示添加到通讯录。.vcf 文件里存的也是完全相同的格式。

    本文逐行讲解这种格式,告诉你该用哪个版本、能存多少数据,以及什么时候更适合让 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:[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 二维码制作工具会根据你填写的表单自动生成:

    1. 打开 QR Cake vCard 名片二维码生成器。
    2. 填写姓名、公司、职位、电话号码、邮箱和网站。如果想在名片上展示照片和社交账号,也可以添加。
    3. 用你的颜色、logo 或边框设计二维码,边框上可以加一句“扫码保存我的联系方式”之类的标签。
    4. 用免费账号登录并保存二维码,然后下载为 PNG 或 SVG。
    5. 分别用 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 Team

    关于 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 二维码需要联网,因为扫码会打开一个存有联系人的网页。
    vCard 二维码格式详解:字段、版本与完整示例