福昕开发者文档中心

福昕转换 SDK v3.1.0 ​

发布日期：2026 年 3 月 31 日

不兼容变更 ​

PDF2WordSettingData — 参数变更与默认值变更 ​

参数化构造函数和 Set() 方法新增必选参数 max_blank_paragraphs_per_page_bottom：

cpp
// v3.0（4 个参数）
PDF2WordSettingData(bool enable_retain_page_layout,
    bool enable_generate_headers_and_footers,
    bool enable_generate_footnotes_and_endnotes,
    bool enable_generate_page_rendered_break);

// v3.1（5 个参数）
PDF2WordSettingData(bool enable_retain_page_layout,
    bool enable_generate_headers_and_footers,
    bool enable_generate_footnotes_and_endnotes,
    bool enable_generate_page_rendered_break,
    int max_blank_paragraphs_per_page_bottom);  // 新增

所需操作： 使用参数化构造函数或 Set() 时需补充新参数。传 -1 表示不限制（与旧版行为一致）。也可改用默认构造函数 + 字段赋值方式，不受影响。

默认值变更 — enable_generate_headers_and_footers 从 false 改为 true。使用默认构造函数的代码，转换结果将自动生成页眉页脚。如需保持旧版行为，需显式设置 enable_generate_headers_and_footers = false。

PDF2PowerPointSettingData — 参数变更 ​

参数化构造函数和 Set() 方法新增必选参数 enable_adapt_to_largest_page：

cpp
// v3.0（1 个参数）
PDF2PowerPointSettingData(bool enable_aggressively_split_sections);

// v3.1（2 个参数）
PDF2PowerPointSettingData(bool enable_aggressively_split_sections,
    bool enable_adapt_to_largest_page);  // 新增

所需操作： 补充新参数，传 false 保持旧版行为。

PDF2ExcelSettingData — 参数变更 ​

参数化构造函数和 Set() 方法新增 2 个必选参数：

cpp
// v3.0（3 个参数）
PDF2ExcelSettingData(String decimal_symbol, String thousands_separator,
    WorkbookSettings workbook_settings);

// v3.1（5 个参数）
PDF2ExcelSettingData(String decimal_symbol, String thousands_separator,
    WorkbookSettings workbook_settings,
    bool enable_aggressive_table_repair,  // 新增
    bool include_watermarks);             // 新增

所需操作： 补充 2 个新参数，传 true, false 保持旧版行为。

PDF2OfficeSettingData — 参数变更 ​

参数化构造函数和 Set() 方法新增必选参数 enable_matching_system_fonts：

cpp
// v3.0（9 个参数）
PDF2OfficeSettingData(const wchar_t* metrics_data_folder_path,
    bool enable_ml_recognition, const Range& page_range,
    bool include_pdf_comments,
    const PDF2WordSettingData& word_setting_data,
    const PDF2PowerPointSettingData& power_point_setting_data,
    const PDF2ExcelSettingData& excel_setting_data,
    bool enable_trailing_space, bool include_images);

// v3.1（10 个参数）
PDF2OfficeSettingData(/* 同上 9 个参数 */,
    bool enable_matching_system_fonts);  // 新增

所需操作： 补充新参数，传 false 保持旧版行为。

PDF 转 Word 默认行为变更 ​

PDF 转 Word 现在默认保留文档内部跳转链接。如下游流程依赖无链接的 Word 输出，升级后需验证转换结果。

新增功能与增强 ​

PDF 转 Office ​

  • 新增 PDF2OfficeSettingData 的 enable_matching_system_fonts 参数，用于 PDF 转 Word 时启用系统字体精准匹配
  • 新增 PDF2PowerPointSettingData 的 enable_adapt_to_largest_page 参数，将混合页面尺寸 PDF 的较小页面自动缩放至最大页面尺寸以统一幻灯片大小
  • 新增 PDF2ExcelSettingData 的 enable_aggressive_table_repair 和 include_watermarks 参数，用于强化表格结构修复，并控制是否在 Excel 输出中保留水印内容
  • 改进 PDF 转 Word 转换，默认保留文档内部跳转链接（目录、交叉引用）
  • 改进 PDF 转 Word 的转换性能，降低复杂文档的内存占用
  • 改进 PDF 转 Word 的标题识别准确率，提升 Word 标题样式映射效果
  • 改进 PDF 转 Word 的段落识别、分页符处理及跨页表格连续性

Office 转 PDF ​

  • 新增 Linux 平台对 Office2PDFSettingData::is_embed_font 字体嵌入开关的支持
  • 新增 Office2PDF::ConvertFromWord 对 DOC（Word 97-2003）格式的支持
  • 新增 e_ErrNotMatchFont 错误码，用于 Office 转 PDF 时字体缺失场景

平台 ​

  • 新增 Linux ARM64 .NET Core 平台支持
  • 提供中文开发者接口文档

问题修复 ​

PDF 转 Word ​

  • 修复在 Linux .NET 平台上将特定 PDF 文件转换为 Word 时崩溃的问题
  • 修复特定文档 PDF 转 Word 时无法生成输出文件且无明确错误提示的问题
  • 修复在 Debug x86 模式下某些 MFC 项目中 PDF 转 Word 时出现异常（0x77574080 ntdll.dll）的问题
  • [Linux] 修复宋体在转换后的 Word 输出中被错误渲染为黑体的字体替换问题
  • 改进字体选择策略，避免使用 Segoe UI Light 以提升 WPS Office 跨应用兼容性
  • 修复转换后 Word 文档中字体样式（如加粗）丢失的问题
  • 修复 PDF 转 Word 时字号不正确导致布局错乱的问题
  • 修复转换后 Word 文档段落内字符间出现多余空格的问题
  • 修复转换后 Word 文档中标题字符重叠的问题
  • 改进翻译回填工作流的布局稳定性，修复翻译后较长文本导致后续页面布局混乱的问题
  • 修复页面四角生成裁切线影响第三方翻译软件处理的问题
  • 修复转换后 Word 文档中目录对齐错位的问题
  • 修复特定文件转换后 Word 文档中出现布局错位的问题
  • 修复 PDF 页眉页脚被错误转换为正文文本而非 Word 页眉/页脚区域的问题
  • 修复文本行末多余换行符在翻译回填时导致布局错乱的问题
  • 修复阿拉伯语文档 PDF 转 Word 时内容丢失的问题
  • 改进大型文档的转换质量：减少布局问题、输出文件体积膨胀和页数增长
  • 改进 Microsoft Office 与 WPS Office 之间的跨应用渲染一致性
  • 修复特定文件转换时文字变淡、表格渲染异常、内容丢失及文本重叠的问题
  • 修复 PDF 转 Word 时目录丢失或损坏、标题未被正确识别的问题
  • 修复 PDF2WordSettingData 中 enable_generate_headers_and_footers = true 不生效的问题

PDF 转 Excel ​

  • 修复 PDF 转 Excel 时单元格文本被放置在绘图形状内而非可编辑单元格中的问题
  • 修复转换耗时过长且表格结构不正确、单元格以图像形式呈现的问题
  • 修复使用内置测试文档转换为 Excel 时内容丢失的问题

Word 转 PDF ​

  • 修复 Office2PDF::ConvertFromWord 转换特定 DOCX 文件时崩溃的问题
  • 修复转换特定 Word 文件时内存飙升至 4 GB 导致卡死的问题
  • 修复 Word 转 PDF 时特定表格区域内容丢失的问题
  • 改进 Windows 平台上的字符间距和段落布局还原度
  • 修复 Windows 平台上 Office2PDFSettingData 中 is_embed_font = true 不生效的问题
  • [Linux] 修复缺少 Calibri 字体的 Red Hat 系统上 Word 转 PDF 输出空白的问题
  • 修复字符间距不正确导致换行位置与原始 Word 文档不同的问题
  • 修复加粗文本在转换后的 PDF 中显示过粗的问题
  • 修复特定文档的最后一句话在输出 PDF 中丢失的问题
  • 修复图形形状渲染偏差和文本换行错误的问题