MigraDoc渲染Unicode字符问题：C#生成PDF中文显示方块求助

你遇到的方块（俗称"tofu"）问题，本质是当前指定的字体不包含目标字符的字形，再加上MigraDoc 1.32这个老版本对非拉丁字体的支持有局限，导致无法正确渲染中文“彤”。下面是具体的解决办法：

1. 更换支持完整中日韩字符的系统字体 #

Lucida Sans Unicode只覆盖了少量中日韩常用字符，“彤”不在它的字符集中。换成Windows系统自带的、完全支持中文的字体就能解决问题，比如：

Style style = doc.Styles["Normal"];
// 微软雅黑（推荐，渲染效果清晰）
style.Font.Name = "Microsoft YaHei";
// 或者宋体（系统默认中文宋体）
// style.Font.Name = "SimSun";

⚠️ 注意：代码里要使用字体的英文名称，而不是中文名称，否则系统可能找不到对应的字体。

2. 确认字体嵌入和系统字体可用性 #

你已经设置了PdfFontEmbedding.Always，这一步是对的，但可以额外检查：

• 打开生成的PDF，查看「文件属性-字体」，确认你指定的字体是否被成功嵌入；
• 确保你的系统确实安装了该字体（比如在Windows字体设置里搜索“Microsoft YaHei”）。

3. 升级MigraDoc版本（最推荐） #

MigraDoc 1.32是2016年的旧版本，对Unicode非拉丁字符的支持存在不少缺陷。升级到最新的PDFsharp&MigraDoc（比如1.50及以上版本）后，不仅能更好地处理中日韩字符，还修复了很多字体相关的bug，同时支持更灵活的字体嵌入方案（比如嵌入自定义字体文件）。

额外调试小技巧 #

• 可以先在Word里测试字体：输入“彤”后切换到你指定的字体，看是否能正常显示，以此排除字体本身的问题；
• 如果是跨平台运行（比如Linux/macOS），需要确保目标系统上有对应的中文字体，或者将字体文件打包到程序中并通过代码指定字体路径。

内容的提问来源于stack exchange，提问作者Martin Slezák