如何在Apple Wallet中正确格式化vCard以生成可识别的条码/QR码？

数据老陈

2026-7-6

Apple Wallet嵌入自包含vCard条码的正确格式化方案

核心解决思路

Apple Wallet的条码message字段要求内容是符合JSON语法规范的原始vCard文本，扫描器需要直接解析标准vCard结构，因此关键是处理好JSON转义和vCard的换行格式。

正确格式化步骤

保留vCard标准字段结构，不修改内容，仅处理换行符
将vCard中的换行（\n或\r\n）通过JSON序列化工具自动转义为合法的JSON字符串格式（避免手动转义出错）
禁止使用URL编码，扫描器期望直接读取原始vCard文本，编码会破坏数据结构
优先选择PKBarcodeFormatQR或PKBarcodeFormatAztec格式，二者容量足够容纳完整vCard；Code128容量有限，大概率无法放下你的示例vCard

PHP实现示例

// 原始vCard内容
$vcard = <<<VCARD
BEGIN:VCARD
VERSION:3.0
REV:2023-11-08T00:00:00Z
N:Murphy;Jill;;;
ORG:Company
TITLE:Developer
EMAIL;INTERNET;WORK:test@example.com
URL:https://example.com
END:VCARD
VCARD;

// 构造Apple Wallet条码配置
$passConfig = [
    "barcode" => [
        "format" => "PKBarcodeFormatQR",
        "message" => $vcard,
        "messageEncoding" => "iso-8859-1"
    ]
];

// 生成符合规范的JSON（json_encode会自动处理换行转义）
$passJson = json_encode($passConfig, JSON_PRETTY_PRINT);