vCard 电子名片指南：一个 .vcf 文件里能装下什么
纸质名片递出去，对方还得一个字一个字敲进通讯录。vCard 解决的就是这一步：它是一种电子名片的通用文件格式，通常以 .vcf 为后缀，里面用纯文本写清一个人的联系方式。收到文件的人点一下导入，姓名、电话、邮箱、公司就都进了通讯录，不用手动录入，也不用担心抄错一位数字。
一张名片文件里有什么
一个最简单的 vCard 文件长这样，下面的人名、电话、邮箱全部是占位示例：
BEGIN:VCARD
VERSION:3.0
FN:张三（示例）
N:张;三;;;
ORG:示例公司
TITLE:示例职位
TEL;TYPE=CELL:138-0000-0000
TEL;TYPE=WORK:010-0000-0000
EMAIL:zhangsan@example.com
ADR;TYPE=WORK:;;示例路 1 号;示例市;;100000;示例国
URL:https://www.example.com
NOTE:这是一个格式示例，请勿当作真实联系方式使用。
END:VCARD开头和结尾的两行是固定标记，说明这是一张名片。中间每一行是一个字段，冒号前面是字段名，后面是内容。FN 是显示用的全名，N 是拆开的姓与名，TEL 后面的 TYPE 说明这个号码是手机还是工作电话，EMAIL、ORG、ADR、URL 分别对应邮箱、公司、地址和网址。字段的顺序没有强制要求，常用的写全就够了，不常用的大可以不写。
版本值得单独说一句。现在流通的 vCard 主要是 3.0 和 4.0 两个版本，3.0 的兼容面最广，几乎所有手机和邮箱客户端都认；4.0 增加了一些新字段和更规范的写法，但在个别老设备上可能有字段被忽略。没有特殊需求时，用 3.0 写是最稳妥的选择，写好一张 3.0 的名片，换什么设备都能打开。
示例一：把名片导入手机
这是 vCard 最常见的用法。假设朋友发来一个 .vcf 文件，你在手机上点开它，系统会问是否添加到通讯录，确认之后，这个人就出现在联系人列表里，电话和邮箱都已经填好，直接就能拨号或者写邮件。
如果一次收到好几张名片，比如展会上加了一圈人，也可以把多个 vCard 合并到同一个 .vcf 文件里再导入。做法是把每张名片的 BEGIN:VCARD 到 END:VCARD 段落按顺序拼在一起，存成一个文件，一次导入全部联系人。合并时注意每张名片的段落要完整，缺了结尾标记的那一张会导入失败，连带后面的也可能受影响。
导入之后顺手做一件事：搜一下这个人的名字，确认电话和邮箱都写对了位置。有些手机会把工作电话和手机分开展示，有些则混在一起，提前看一眼，比事后发现打错电话要省事。
示例二：在邮件签名里附一张名片
经常对外联系的人，可以在邮件签名里附上自己的 vCard 文件。对方收到邮件后点一下附件，联系方式就进了他的通讯录，比在签名档里贴一串电话号码更不容易出错，也显得更正式。
具体做法是在邮箱客户端的签名设置里，把写好的 .vcf 文件作为附件固定下来。写这张名片时要克制，只放对方真正需要的字段：姓名、手机、工作邮箱、公司和网址就够了。家庭住址、私人电话、内部直线这类信息不适合放进对外分发的名片，名片一旦发出去，就收不回来了。
还有一个细节：名片里的邮箱最好和发件邮箱一致。对方点开名片看到的邮箱，和邮件发件人对不上，会让人怀疑这封邮件是不是冒充的，严谨一点能省去很多不必要的解释。
示例三：把名片做成二维码
线下见面时，二维码比传文件更顺手。做法是把上面那段 vCard 文本原样放进二维码生成器，生成一张二维码图片，印在纸质名片背面、会议胸牌或者展台立牌上。对方用手机相机一扫，就会弹出添加联系人的确认框，整个过程不用加微信、不用互发文件。
二维码版名片有一个容量上限，内容越长，二维码的点阵就越密，也就越难扫。所以二维码里只放核心字段：姓名、一个手机号码、一个邮箱，顶多再加公司名。地址、备注、个人主页这些长内容不适合塞进二维码，扫不出来就白做了。生成之后一定要用两部不同的手机实测一次，确认扫出来的人名没有乱码、电话可以直接拨打，再拿去印刷。
示例四：一次生成一叠名片
团队或者活动主办方常常需要批量制作名片，比如给二十位讲者每人做一张。手动写二十个文件既慢又容易出错，用脚本批量生成更可靠。思路是先准备一张联系人表格，每行一个人，每列一个字段，然后用脚本按行生成对应的 .vcf 文件。
下面是一个思路示例，数据全部是占位内容：
people = [
{"name": "李四（示例）", "phone": "139-0000-0000", "email": "lisi@example.com"},
{"name": "王五（示例）", "phone": "137-0000-0000", "email": "wangwu@example.com"},
]
for p in people:
text = f"""BEGIN:VCARD
VERSION:3.0
FN:{p["name"]}
TEL;TYPE=CELL:{p["phone"]}
EMAIL:{p["email"]}
END:VCARD
"""
open(f"{p['name']}.vcf", "w", encoding="utf-8").write(text)批量生成之后不要直接分发，先抽查两三张：用手机导入一张，确认姓名和电话没有错位；再检查一遍表格里有没有空字段，空字段生成的空行虽然不影响导入，但会让名片看起来不完整。
名片写好之后怎么管
一张名片写好并不是结束，它还有后续的维护问题。最常见的情况是换了工作或者换了手机号，旧名片却还在别人手里流传。给名片文件起一个带日期的名字，比如把年份写进文件名，是一种简单有效的办法，收到的人一眼就能看出这张名片是不是最新版。自己手里也要留一份主文件，存在一个固定的地方，每次更新都改这一份，再重新分发，而不是每次都新建一个文件，时间一长就分不清哪个版本才是最新的。
对外分发过的名片是收不回来的，所以更新联系方式时，除了发新名片，最好直接告诉常联系的人一声。对方通讯录里的旧条目不会因为你发了新名片就自动更新，很多人是等到电话打不通才发现号码已经换了。重要的联系人变更，口头或者消息提醒一次，比单纯发文件更可靠。
各平台的兼容性差异
vCard 是通用格式，但各家客户端处理起来并不完全一致，提前知道差异能少踩很多坑。
苹果的通讯录对 3.0 和 4.0 都支持得比较好，照片、多个电话、自定义字段基本都能原样呈现。安卓的情况要分开看：系统自带的通讯录应用通常没问题，但各厂商预装的通讯录在字段处理上有自己的习惯，比如有的会把工作电话和手机合并显示，有的对 vCard 4.0 的新字段直接忽略。给安卓用户发名片时，用 3.0 写、字段写常规名称，是兼容性最好的做法。
桌面端也类似。Outlook 和 macOS 通讯录都能导入 .vcf，但 Outlook 对中文姓名的显示偶尔依赖文件的编码，文件必须存成 UTF-8 编码，否则人名可能显示成乱码。网页版邮箱导入时也要注意：有些网页通讯录一次只接受单个联系人，合并了多张名片的文件传上去可能只认第一张，批量导入前先看一眼该服务的说明。
照片是另一个容易出问题的地方。vCard 支持在文件里内嵌头像，但照片太大会让文件体积暴涨，二维码也放不下，邮件附件也会变大。名片里放照片时，把图片压缩到几十 KB 再内嵌，或者干脆不放照片，只留文字信息，是更稳妥的做法。
常见问题
导入后人名显示成乱码，十有八九是编码问题。vCard 文件要存成 UTF-8 编码，用记事本或者文本编辑器另存时确认编码选项，不要用系统默认的本地编码。已经乱码的联系人删掉重导一次就行，文件本身改对编码后就不会再出问题。
电话类型丢失是另一个常见现象：明明写了手机和工作电话两个号码，导入后却只剩一个，或者两个都被标成手机。这通常是接收方的通讯录对 TYPE 参数的理解不同造成的，换一个写法有时就能解决，比如把 TYPE=CELL 改成 TYPE=CELL,VOICE，或者去掉不常用的类型标注。对方的设备千差万别，名片写得越常规，丢失字段的概率越低。
导入后出现重复联系人，一般是因为对方通讯录里已经有这个人，而新名片的姓名写法和旧条目不一致，系统没认出是同一个人。处理办法是先在通讯录里搜一下这个人的名字，把旧条目删掉或者合并，再重新导入。批量导入前先提醒对方清理一遍旧联系人，能省去事后逐条合并的麻烦。
二维码扫出来是乱码或者扫不出内容，先看内容长度，再看编码。二维码里的 vCard 文本同样要是 UTF-8，内容控制在核心字段以内，点阵太密的二维码在光线不好的地方很难一次扫中。重新生成一张内容更精简的，问题往往就解决了。
最后提醒一句：vCard 文件是纯文本，任何人拿到文件都能直接看到里面的全部内容。发之前检查一遍文件里有没有不该公开的信息，确认无误再发出去。通过聊天软件传文件时还要注意，有些应用会改掉附件的后缀名或者把它当成普通文本打开，对方收到的文件如果打不开，先确认后缀是不是 .vcf，改回正确的后缀再导入，往往就能恢复正常。
延伸阅读
免责声明
本文仅供技术交流和学习参考。涉及第三方服务的链接可能包含 sponsored 标记，请自行核实服务条款、价格和可用性，并遵守当地法律法规。
想了解更多通讯录与账号管理的内容，可以看看站内的 Oracle Cloud 免费注册教程。