使用PDFLib.Objects生成PDF时出现编码问题求助（.NET环境）

问题原因 #

你遇到的Boétie变成Boé️tie是典型的UTF-8字符被错误以ASCII编码解析/输出导致的乱码——特殊字符é的UTF-8字节序列被当作ASCII逐个解析，从而产生乱码。

解决方案 #

1. 确保文本源的编码正确性 #

在.NET中，字符串默认是Unicode，但如果是从文件/外部读取文本，必须明确指定UTF-8编码读取：

// 从文件读取时指定UTF-8
string text = File.ReadAllText("path/to/your/text.txt", Encoding.UTF8);

如果是硬编码字符串，直接写"Boétie"即可，.NET会正确保留Unicode字符。

2. 使用支持Unicode的PDF字体并嵌入 #

PDF默认的基础字体（如Helvetica）只支持ASCII范围字符，必须使用支持Unicode的TrueType字体并嵌入，才能正确显示特殊字符：

// 加载系统中的Unicode字体（比如微软雅黑）
var font = new Font("Microsoft YaHei", FontSize.Point(12));
// 确保嵌入字体到PDF中
font.Embedding = FontEmbedding.Embed;

// 创建文本对象时使用该字体
var textObj = new Text(text, font)
{
    // 明确指定文本编码为UTF-8
    Encoding = Encoding.UTF8
};

3. 检查PDF输出流的编码设置 #

如果是将PDF写入文件或流，确保使用UTF-8编码而非默认的ASCII：

using (var stream = new FileStream("output.pdf", FileMode.Create))
{
    var document = new Document();
    document.Add(textObj);
    // 写入时指定UTF-8编码
    document.Save(stream, Encoding.UTF8);
}

4. 验证PDFLib.Objects的全局编码配置 #

部分版本的PDFLib.Objects可能有全局编码设置，检查是否被设置为ASCII，改为UTF-8：

// 全局设置默认编码为UTF-8
PdfLib.GlobalSettings.DefaultEncoding = Encoding.UTF8;

内容的提问来源于stack exchange，提问作者Shaik Habeeb