Outlook桌面版vCard德语文本显示异常问题求助

通过PHP结合WordPress ACF生成vCard时，德语文本（如für）在Outlook桌面版显示为für，但移动端显示正常。原生成代码如下：

function generate_vcard($post_id) {
    // Get ACF field values for the post
    $title = utf8_encode(get_field('title', $post_id));
    $first_name = utf8_encode(get_field('first_name', $post_id));
    $last_name = utf8_encode(get_field('last_name', $post_id));
    $position = utf8_encode(get_field('position', $post_id));
    $company = utf8_encode(get_field('company', $post_id));
    $birthday = utf8_encode(get_field('birthday', $post_id));
    $office_phone = utf8_encode(get_field('office_phone', $post_id));
    $cell_phone = utf8_encode(get_field('cell_phone', $post_id));
    $email_1 = utf8_encode(get_field('email_1', $post_id));
    $email_2 = utf8_encode(get_field('email_2', $post_id));
    $website = utf8_encode(get_field('website', $post_id));

    // Get profile image URL from ACF field
    $profile_image = get_field('profile_image', $post_id);

    // Encode the image to base64
    $image_data = file_get_contents($profile_image);
    $base64_image = base64_encode($image_data);

    // Generate vCard content
    $vcard = "BEGIN:VCARD
";
    $vcard .= "VERSION:3.0
";
    $vcard .= "PHOTO;TYPE=JPEG;ENCODING=b;VALUE=URL:$base64_image
";
    $vcard .= "FN:$first_name $last_name
";
    $vcard .= "N:$last_name;$first_name;;;
";
    $vcard .= "ORG;CHARSET=windows-1252:$company
";
    $vcard .= "TITLE:$position
";
    $vcard .= "BDAY:$birthday
";
    $vcard .= "TEL;TYPE=WORK,VOICE:$office_phone
";
    $vcard .= "TEL;TYPE=CELL,VOICE:$cell_phone
";
    $vcard .= "EMAIL:$email_1
";
    $vcard .= "EMAIL:$email_2
";
    $vcard .= "URL:$website
";
    $vcard .= "END:VCARD
";

    // Set headers to trigger download with Windows-1252 encoding
    header("Content-Type: text/vcard; charset=windows-1252");
    header("Content-Disposition: attachment; filename=contact.vcf; charset=windows-1252");

    // Output vCard content with Windows-1252 encoding
    echo $vcard;
    exit;
}

add_action('wp', 'export_vcard');
function export_vcard() {
    if (isset($_GET['export_vcard']) && $_GET['export_vcard'] == 1) {
        $post_id = get_the_ID();
        generate_vcard($post_id);
    }
}

尝试改为UTF-8编码后问题仍未解决，请问原因及修复方案？

问题原因 #

1. 双重UTF-8编码：WordPress和ACF默认以UTF-8存储内容，调用utf8_encode()会对已编码的UTF-8文本二次编码，导致特殊字符（如ü）被错误转换为多层编码的乱码。
2. 编码声明不一致：部分字段指定CHARSET=windows-1252，但输出头编码混用，且vCard 3.0未统一声明UTF-8，导致Outlook桌面版解析混乱。
3. PHOTO字段格式错误：vCard 3.0中BASE64嵌入的照片不应使用VALUE=URL，该参数用于指向外部图片链接，直接嵌入需移除该声明。

修复方案 #

步骤1：移除不必要的utf8_encode()调用 #

ACF返回的字段值已是UTF-8编码，无需二次处理。

步骤2：统一vCard的UTF-8编码声明 #

在所有含文本的字段中明确CHARSET=UTF-8，同时响应头也指定UTF-8编码。

步骤3：修正PHOTO字段格式 #

移除VALUE=URL参数，符合vCard 3.0的BASE64照片嵌入规范。

完整修复代码 #

function generate_vcard($post_id) {
    // 获取ACF字段值（默认UTF-8编码，无需额外处理）
    $title = get_field('title', $post_id);
    $first_name = get_field('first_name', $post_id);
    $last_name = get_field('last_name', $post_id);
    $position = get_field('position', $post_id);
    $company = get_field('company', $post_id);
    $birthday = get_field('birthday', $post_id);
    $office_phone = get_field('office_phone', $post_id);
    $cell_phone = get_field('cell_phone', $post_id);
    $email_1 = get_field('email_1', $post_id);
    $email_2 = get_field('email_2', $post_id);
    $website = get_field('website', $post_id);

    // 处理头像BASE64编码（增加空值判断）
    $base64_image = '';
    $profile_image = get_field('profile_image', $post_id);
    if ($profile_image) {
        $image_data = file_get_contents($profile_image);
        $base64_image = base64_encode($image_data);
    }

    // 生成符合UTF-8规范的vCard内容
    $vcard = "BEGIN:VCARD\r\n";
    $vcard .= "VERSION:3.0\r\n";
    if ($base64_image) {
        $vcard .= "PHOTO;ENCODING=b;TYPE=JPEG:$base64_image\r\n";
    }
    $vcard .= "FN;CHARSET=UTF-8:$first_name $last_name\r\n";
    $vcard .= "N;CHARSET=UTF-8:$last_name;$first_name;;;\r\n";
    $vcard .= "ORG;CHARSET=UTF-8:$company\r\n";
    $vcard .= "TITLE;CHARSET=UTF-8:$position\r\n";
    if ($birthday) $vcard .= "BDAY:$birthday\r\n";
    if ($office_phone) $vcard .= "TEL;TYPE=WORK,VOICE:$office_phone\r\n";
    if ($cell_phone) $vcard .= "TEL;TYPE=CELL,VOICE:$cell_phone\r\n";
    if ($email_1) $vcard .= "EMAIL;TYPE=WORK:$email_1\r\n";
    if ($email_2) $vcard .= "EMAIL;TYPE=HOME:$email_2\r\n";
    if ($website) $vcard .= "URL;TYPE=WORK:$website\r\n";
    $vcard .= "END:VCARD\r\n";

    // 设置正确的响应头
    header("Content-Type: text/vcard; charset=UTF-8");
    header("Content-Disposition: attachment; filename=contact.vcf");

    // 输出vCard内容
    echo $vcard;
    exit;
}

add_action('wp', 'export_vcard');
function export_vcard() {
    if (isset($_GET['export_vcard']) && $_GET['export_vcard'] == 1) {
        $post_id = get_the_ID();
        generate_vcard($post_id);
    }
}

额外注意事项 #

• 确保WordPress数据库字符集为utf8mb4，避免存储阶段的编码丢失。
• 测试时先下载vCard文件，用文本编辑器打开确认无乱码后再导入Outlook。

内容的提问来源于stack exchange，提问作者sobuz islam