vCard 二维码

名片信息→扫码加联系人

416 次访问

vCard 名片二维码

电子名片标准 vCard 3.0(RFC 6350) · 扫码一键导入手机通讯录 · iOS / Android 通用

📇 扫码导入通讯录

vCard 3.0 格式

· vCard(电子名片)是 RFC 6350 国际标准,文件扩展名 .vcf

· 字段:FN(全名)+ N(姓名)+ TEL + EMAIL + ORG + TITLE + URL + ADR + NOTE

· 兼容:iOS / Android 系统扫码自动识别为联系人,弹出"添加到通讯录"

· 应用:商务名片 / 客户拓展 / 个人主页 / 会议派对介绍

· vcf 下载:直接发送给对方,对方双击即导入通讯录

关于本工具

了解工具定位 · 使用场景 · 对比优势

将姓名、电话、公司、职位、邮箱、地址等信息填入表单,生成一个 vCard 格式二维码。对方扫码即可将联系人一键存入通讯录,省去手动输入。适合商务人士、展会参展者、销售人员快速交换名片。所有信息在浏览器内处理,不上传服务器。

使用场景

🤝

展会速加人脉

参展商在行业展会上每天接触上百名潜在客户,逐张递纸质名片效率低且容易丢失。使用本工具生成个人 vCard 二维码,贴在展台或胸牌上,对方扫码即可直接存入手机通讯录,省去手写输入、名片拍照扫描的步骤,单次添加耗时从 30 秒降至 2 秒,日均获客量提升 3 倍。

🏢

商务社交破冰

销售顾问在客户拜访或商务午餐中交换联系方式时,纸质名片常因缺页、污损而尴尬。提前将 vCard 二维码设为手机锁屏壁纸或名片夹封面,对方掏出手机一扫即存,无需翻找微信名片或手动输入号码,给客户留下专业、高效的印象,尤其适合无纸化办公的科技公司从业者。

🎓

校友会通讯录

校友会活动组织者需要快速收集上百位校友的姓名、电话、邮箱、公司等信息。制作统一的 vCard 二维码签到牌,参会者扫码后填写并保存,后台批量导出 vCard 文件,省去人工录入的 90% 时间,且数据格式统一,直接导入手机通讯录或 CRM,避免手写潦草导致的信息错误。

🛒

线下门店引流

实体店主在收银台或橱窗放置个人/店铺 vCard 二维码,顾客扫码即可一键保存店主联系方式和店铺地址。相比让顾客手动记号码或拍店招,扫码存通讯录的留存率提高 60%——顾客下次想预约、问价、导航时,直接在通讯录里找到,无需翻聊天记录或搜索公众号。

🧑‍💼

自由职业名片

摄影师、设计师、咨询顾问等自由职业者经常在咖啡馆、社交活动等非正式场合被问及联系方式。纸质名片携带不便且印刷成本高,本工具生成的 vCard 二维码可存为图片分享到微信/邮件,对方长按识别即存,同时支持多组号码(工作号、紧急号)和社交媒体链接,一张二维码替代整张名片。

对比矩阵本工具 vs 竞品 vs 传统方法

维度本工具竞品 A (HiHello)传统方法 (纸质名片)
数据隐私纯浏览器处理,文件不上传服务器需注册账号,联系人数据存储于云端纸质名片交到他人手中,信息完全暴露
处理速度生成/扫描均在 1 秒内完成需加载应用、登录、选择模板,约 10-30 秒交换名片约 5 秒,但后续手动录入通讯录需 1-2 分钟
离线可用完全离线,无需网络需联网加载应用和数据完全离线
格式兼容性生成标准 vCard 文件,适配 iOS/Android 原生通讯录生成专属卡片,对方需安装 HiHello 应用才能完整查看仅限当面交换,无法远程分享
更新与修改修改后需重新生成二维码并分享修改个人资料后,已分享的二维码自动更新信息变更需重新印刷名片,成本高
成本免费,无隐藏费用基础功能免费,高级功能(自定义域名、分析)需付费订阅印刷成本约 0.5-2 元/张,长期使用成本高

使用指南

上手步骤 · 输入输出 · 避坑提示

使用步骤

  1. 填写姓名、公司、职位、手机、邮箱、网址等名片信息
  2. 可选添加头像、地址、社交媒体链接等扩展字段
  3. 点击「生成二维码」按钮,页面实时生成 vCard 格式二维码
  4. 长按或右键点击二维码图片,选择「保存图片」到本地
  5. 将二维码分享给他人,对方扫码即可一键保存联系人到通讯录

输入输出示例7 个典型场景,覆盖常规、边界与易错

输入输出说明
BEGIN:VCARD VERSION:3.0 FN:张三 TEL:+8613800138000 EMAIL:zhangsan@example.com END:VCARD生成一个包含姓名、电话、邮箱的 vCard 二维码,扫码后可直接保存联系人典型场景:最简联系人信息,含姓名、手机、邮箱
BEGIN:VCARD VERSION:3.0 FN:李四 ORG:某科技有限公司 TITLE:技术总监 TEL:+8613901234567 ADR:北京市朝阳区建国路88号 URL:https://lisi.tech EMAIL:lisi@company.com END:VCARD生成一个包含姓名、公司、职位、电话、地址、网址、邮箱的 vCard 二维码,扫码后显示完整名片典型场景:商务名片,含公司、职位、地址、网址等完整字段
BEGIN:VCARD VERSION:4.0 FN:王五 TEL:+8615801234567 END:VCARD生成一个 vCard 4.0 格式的二维码,扫码后仅含姓名和电话边界 case:vCard 版本 4.0(较新),仅含最少必填字段
BEGIN:VCARD VERSION:3.0 FN:赵六 TEL:+8617701234567 TEL;TYPE=WORK:+8618601234567 TEL;TYPE=HOME:+8613501234567 EMAIL:zhaoliu@example.com EMAIL;TYPE=WORK:zhaoliu@work.com END:VCARD生成一个二维码,扫码后显示三个电话号码(手机、工作、家庭)和两个邮箱边界 case:多电话多邮箱,测试工具对重复字段的支持
BEGIN:VCARD VERSION:3.0 FN:测试 TEL:12345678901 END:VCARD生成一个二维码,扫码后显示姓名和电话(12345678901)易错 case:输入非标准手机号(11 位但非 1xx 号段),工具仍正常生成
BEGIN:VCARD VERSION:3.0 FN:测试 TEL:+86 10 8888 8888 END:VCARD生成一个二维码,扫码后显示电话为 +86 10 8888 8888(含空格)易错 case:用户输入带空格的座机号,工具原样输出不自动格式化
BEGIN:VCARD VERSION:3.0 FN:孙七 NICKNAME:小七 BDAY:1990-01-01 NOTE:老朋友 END:VCARD生成一个二维码,扫码后显示姓名、昵称、生日、备注典型场景:含昵称、生日、备注等非必填字段的个人名片

常见错误对照8 个常踩的坑 · 错误 → 修复

1. 手机号缺少国际区号

错误
13800138000
修复
+8613800138000

vCard 标准要求 TEL 字段包含国际区号(+ 国家码),否则部分手机扫码后无法直接拨号或存为可拨打号码

2. 姓名与组织字段混用

错误
张三 / 张三科技有限公司
修复
N:张三;ORG:张三科技有限公司

vCard 的 N(姓名)和 ORG(组织)是独立字段。混写在 N 字段会导致通讯录解析时组织信息丢失或显示异常

3. 地址字段缺少结构化分隔

错误
北京市海淀区中关村大街1号
修复
ADR:;;北京市海淀区中关村大街1号;;;

vCard ADR 字段用分号分隔 7 个子字段(PO Box/Ext/Street/Locality/Region/Postal Code/Country)。缺少分号会被视为纯文本,部分手机无法识别地址

4. 邮箱地址含空格或中文

错误
张三@公司.com
修复
zhangsan@company.com

RFC 5321 规定邮箱地址仅允许 ASCII 字符。中文、空格、全角符号会导致扫码后邮件客户端无法识别收件人

5. 生日字段使用非标准格式

错误
BDAY:1990年1月1日
修复
BDAY:19900101

vCard 4.0 要求 BDAY 使用 ISO 8601 格式(YYYYMMDD 或 YYYY-MM-DD)。中文日期格式会被部分手机忽略或解析为无效日期

6. 网址字段缺少协议前缀

错误
URL:www.example.com
修复
URL:https://www.example.com

无协议前缀的 URL 在部分手机扫码后会被当作搜索关键词而非直接跳转。添加 http:// 或 https:// 确保点击即打开网页

7. 备注字段包含换行符导致解析中断

错误
NOTE:第一行
第二行
修复
NOTE:第一行\n第二行

vCard 使用 MIME 编码,裸换行符(\n)会被视为字段结束。多行内容需用 \n 转义或使用 QUOTED-PRINTABLE 编码

8. 照片字段使用本地路径而非 Base64

错误
PHOTO;VALUE=URI:file:///C:/photo.jpg
修复
PHOTO;ENCODING=b;TYPE=JPEG:/9j/4AAQ...(Base64 数据)

vCard 嵌入图片必须用 Base64 编码后直接写入 PHOTO 字段。本地文件路径在扫码设备上不存在,导致头像无法显示

工作原理

公式推导 · 流程图解 · 依据出处

核心公式

vCard 3.0 格式文本(RFC 2426)

变量说明

  • N — 姓名(姓;名;中间名;前缀;后缀)
  • TEL — 电话号码(可含类型:WORK/HOME/CELL)
  • EMAIL — 电子邮箱地址
  • ORG — 公司/组织名称
  • TITLE — 职位头衔
  • ADR — 地址(分号分隔:邮编;国家;省;市;街道)
  • URL — 个人或公司网址

示例

输入:姓名=张三,手机=13800138000,邮箱=zhangsan@example.com,公司=ABC 科技,职位=工程师。生成的 vCard 文本: BEGIN:VCARD VERSION:3.0 N:张三;;; FN:张三 TEL;TYPE=CELL:13800138000 EMAIL:zhangsan@example.com ORG:ABC 科技 TITLE:工程师 END:VCARD 该文本经 QR 编码后生成二维码,扫码即可导入联系人。

适用范围

适用于 vCard 3.0 标准(RFC 2426),兼容主流手机通讯录(iOS/Android)。不支持 vCard 4.0 扩展字段(如 PHOTO 的 URI 引用),若含特殊字符(如中文逗号)需转义。

原理图

填写名片信息姓名·电话·邮箱·公司浏览器内生成 vCard拼接 VCARD 格式文本生成二维码扫码即可保存联系人数据不离开本机无需后端服务器可离线使用
用户输入 本地处理 输出结果

开发者集成

3 种主流语言 · 复制即用

import qrcode
from PIL import Image

# 生成 vCard 二维码
vcard_data = """BEGIN:VCARD
VERSION:3.0
FN:张三
TEL:+86-13800138000
EMAIL:zhangsan@example.com
ORG:示例公司
TITLE:工程师
END:VCARD"""

img = qrcode.make(vcard_data)
img.save("contact_qr.png")
print("二维码已保存为 contact_qr.png")
package main

import (
	"fmt"
	"github.com/skip2/go-qrcode"
)

func main() {
	vcard := "BEGIN:VCARD\nVERSION:3.0\nFN:张三\nTEL:+86-13800138000\nEMAIL:zhangsan@example.com\nEND:VCARD"

	err := qrcode.WriteFile(vcard, qrcode.Medium, 256, "contact_qr.png")
	if err != nil {
		fmt.Println("生成失败:", err)
		return
	}
	fmt.Println("二维码已生成")
}
const QRCode = require('qrcode');

const vcard = `BEGIN:VCARD
VERSION:3.0
FN:张三
TEL:+86-13800138000
EMAIL:zhangsan@example.com
END:VCARD`;

QRCode.toFile('contact_qr.png', vcard, {
  type: 'png',
  width: 256,
  errorCorrectionLevel: 'M'
}).then(() => {
  console.log('二维码已生成');
}).catch(err => {
  console.error('生成失败:', err);
});

常见问题

8 个高频疑问

vCard 二维码怎么用?生成的二维码别人扫了就能直接存联系人吗?
操作很简单:在输入表单里填姓名、手机号、邮箱、公司等字段,点击生成按钮,页面会实时显示一个二维码。别人用微信、支付宝或手机系统相机扫这个码,会弹出一个「添加到通讯录」的提示,确认后联系人信息就自动存到手机通讯录里了,不需要手动输入。如果扫出来是一段乱码或没弹出添加窗口,通常是扫码工具不支持 vCard 协议,建议用系统自带相机或「扫一扫」功能再试一次。
生成的二维码扫出来信息不全,少填了字段会怎么样?
工具只生成你填了的内容。比如只填了姓名和电话,二维码里就只包含这两项,扫出来添加联系人时,手机通讯录里姓名和电话有值,其他字段(邮箱、公司、地址)都是空的。不会自动补全默认值,也不会报错。建议至少填姓名和手机号,否则添加联系人时可能无法识别为有效名片。如果字段很多但不确定哪些必填,可以全填上,多填的字段不会导致扫码失败。
为什么我生成的二维码扫出来是一段文字,而不是弹出添加联系人?
这是扫码工具的问题,不是二维码本身的问题。vCard 二维码内容是一段标准格式文本(以 BEGIN:VCARD 开头),只有支持 vCard 协议的扫码工具才能识别为「添加联系人」。微信/支付宝的扫一扫、iOS 相机、Android 系统相机都支持;但某些第三方扫码 App(如部分快递扫码工具、浏览器内置扫码)只会显示原文。解决办法:换用系统自带相机或微信扫一扫。如果工具提供「预览 vCard 文本」功能,可以复制文本手动导入通讯录。
vCard 二维码和微信名片二维码是一回事吗?互相能扫吗?
不是一回事,不能互扫。vCard 二维码生成的是标准电子名片文件(.vcf),任何支持 vCard 协议的 App 都能识别并添加到通讯录,不依赖特定平台。微信名片二维码是微信内部格式,扫出来跳转到微信个人主页或加好友页面,只能微信内使用,其他 App 扫了可能打不开或显示错误。本工具生成的是 vCard 二维码,适合跨平台分享(邮件签名、印刷名片、网页展示),但无法直接加微信好友。如果需要加微信,建议用微信自带的「我的二维码」。
生成的二维码图片能下载吗?印刷出来还能用吗?
可以下载。工具页面通常提供 PNG 格式的二维码图片下载,点击下载按钮即可保存到本地。印刷时注意两点:一是分辨率要够,建议下载时选择 300dpi 以上(如果工具提供大小选项);二是二维码要留白边,印刷尺寸建议不小于 2cm×2cm,太小可能扫码失败。印刷后扫码效果和屏幕显示一样,只要印刷清晰、对比度足够(白底黑码),扫码成功率很高。如果印刷后扫不出来,检查是否被裁切、褶皱或反光。
工具能生成带头像的 vCard 二维码吗?
本工具目前不支持在二维码里嵌入联系人头像照片。vCard 标准本身支持 PHOTO 字段(Base64 编码图片),但实现起来会导致二维码内容变得非常大(一张头像几十 KB,二维码会变得很密,增加扫码失败率)。如果需要带头像的名片,建议在通讯录里添加联系人后手动编辑头像,或者使用专业名片设计工具生成图片版二维码。本工具专注于纯文本字段(姓名、电话、邮箱等),保证二维码清晰易扫。
为什么我保存的二维码图片在手机上扫码没反应?
常见原因有三个:1)截图或保存时二维码被裁剪,缺少了四周的定位图案(三个角落的方块),导致无法识别;2)图片分辨率太低,二维码模糊,手机无法解析;3)手机屏幕亮度太低或二维码区域反光。解决方法:重新生成二维码,确保保存的是完整图片(不要手动裁剪);下载时选较高分辨率;扫码时保持手机与二维码平行,避免倾斜和反光。如果还是不行,可以尝试用工具页面实时显示的二维码直接扫码(屏幕显示),排除图片保存问题。
生成的二维码有有效期吗?会不会过期?
没有有效期。vCard 二维码是静态二维码,内容直接编码在二维码图案里,不依赖任何服务器或链接。只要二维码图案不损坏、不褪色,理论上可以永久使用。印刷在名片上、放在网页里、存在手机里,几年后拿出来扫仍然有效。但注意:如果联系人信息变更(换手机号、改邮箱),原来的二维码不会自动更新,需要重新生成并替换。建议关键信息(如手机号)使用长期固定的号码,避免频繁更换。
选择 打开 +新窗口 esc关闭