vCard 文件的作用与结构
vCard 是一种用于存储和交换个人或组织联系人信息的标准文件格式，通常以 .vcf 作为文件扩展名。在数字化联系人管理中，vCard 文件起到了桥梁的作用，允许用户在不同的电子邮件客户端、移动设备和办公软件之间快速导入和导出联系人数据。
一个标准的 vCard 文件由多行文本组成，包含特定的元数据和联系人字段。例如，在导出的 .vcf 文件中，每一行都代表一个特定的属性，如姓名、电话、电子邮箱和地址。为了确保在不同系统间传输时字符不会出现乱码，下载的文件使用 CRLF（回车换行）作为行尾结束符。此外，为了适应网络传输的标准，文件中的长 UTF-8 文本行会被折叠，确保物理行长度不超过 75 个八位字节（octets）。而在浏览器界面中展示的预览内容，则统一使用 LF（换行）作为行尾结束符。
vCard 3.0 与 vCard 4.0 标准的区别
在生成联系人文件时，用户可以在两种主流的 vCard 版本之间进行选择：
- vCard 3.0：这是一个兼容性极广的经典版本。如果需要将联系人导入到较旧的联系人应用程序、车载蓝牙系统或旧款移动设备中，建议选择此版本。在 vCard 3.0 格式的文件中，会包含一个空的结构化姓名（
N）字段，并且电话、电子邮箱和地址字段会分别采用TEL;TYPE=VOICE、EMAIL;TYPE=INTERNET和ADR;TYPE=POSTAL的形式进行标记。 - vCard 4.0：这是目前的最新标准，适用于现代操作系统和最新的邮件客户端。它在数据结构和属性定义上更加规范。
如果在使用过程中发现生成的 .vcf 文件在某个特定设备或应用中无法正常导入，通常可以通过切换另一个版本重新生成来解决兼容性问题。
联系人字段输入规则与验证
为了确保生成的 vCard 文件符合标准语法，输入数据时需要遵循以下字段规则和长度限制：
| 字段名称 | 是否必填 | 最大字符限制 | 格式与行为要求 |
|---|---|---|---|
| 完整姓名 | 是 | 200 个字符 | 保留输入的显示顺序。若留空会触发错误提示：“请输入完整姓名。” |
| 电话 | 否 | 80 个字符 | 仅接受数字、常见的电话标点以及可选的分机号。 |
| 电子邮箱 | 否 | 254 个字符 | 仅接受一个符合标准格式的电子邮箱地址。 |
| 地址 | 否 | 1,000 个字符 | 支持多行输入，文件内会保留换行格式。 |
在输入过程中，如果字段超长或格式不符，系统会触发相应的错误提示，例如“完整姓名不能超过 ‹max› 个字符。”、“请使用数字和常见的电话标点，可选择添加分机号。”、“请按有效格式输入一个电子邮箱地址。”或“地址不能超过 ‹max› 个字符。”。此外，所有输入字段均不能包含控制字符或意外的换行，否则会触发“请移除此字段中的控制字符或意外换行。”的错误。
浏览器本地处理与隐私保护
使用本工具生成 vCard 文件时，你的联系人信息只会留在浏览器中。BroBroGo 不会上传或保存这些信息。所有的格式校验、文件构建和预览渲染均在本地浏览器中完成。
需要注意的是，本工具的校验机制仅针对字段格式和文件语法进行检查，并不会验证联系人的真实身份、授权状态、电话是否可接通、电子邮箱归属以及地址的准确性，也无法保证所有联系人应用都能正常导入。
常见问题解答
应该选择 vCard 3.0 还是 4.0？
如需使用当前标准，请选择 4.0；如需兼容较旧的联系人应用或设备，请选择 3.0。如果某个版本无法正常导入，可以试试另一个版本。
哪些联系人字段是必填的？
只有完整姓名是必填项。电话、电子邮箱和地址均为可选项，留空的可选字段不会写入文件。
姓名和地址会怎样保存？
完整姓名会保留你输入时的显示顺序。多行地址会作为一个完整的地址块保存；如果联系人应用会自动拆分地址，请在导入后再次核对。
为什么修改输入后预览消失了？
在生成 vCard 后，如果你切换 vCard 版本、编辑任何输入字段或清空表单，之前生成的 vCard 预览都会失效，需要重新点击生成。