在服务于中国市场的 C++ 项目中，将 Word 文档转换为 OFD（开放版式文档，国家标准 GB/T 33190）是一项常见需求——无论是后端服务、报表生成器还是文档处理系统，都可能涉及这一场景。然而，传统方案通常依赖 Microsoft Office COM 自动化，部署繁琐，且难以适应服务器端环境。

本文将演示如何使用 Spire.Doc for C++ 通过编程方式实现 Word 转换为 OFD，涵盖基础文档转换与导出指定页面等进阶用法。

• 为什么要将 Word 转换为 OFD？
• 为什么选择 Spire.Doc for C++
• 搭建 Spire.Doc for C++ 开发环境
• 基础转换：在 C++ 中将 Word 转为 OFD
• 进阶：Word 转 OFD 的高级转换设置
  • 将指定页面转换为 OFD
  • 自定义 OFD 转换设置
• 常见问题 (FAQs)

为什么要将 Word 转换为 OFD？

相比便于编辑的 Word 文档，OFD 更适合用于正式发布和长期存档。在中国的政务和企业应用中，将 Word 转换为 OFD 通常具有以下实际价值：

• 排版一致性：可保留原始排版，在不同设备和系统上显示一致。
• 文档标准化：确保在不同平台和阅读器中渲染效果统一。
• 长期存档：适用于法律、财务等长期保存的文档。
• 增强文档完整性：支持数字签名和防篡改机制。
• 支持自动化：可在系统流程中实现程序化转换。

为什么选择 Spire.Doc for C++

在 C++ 中实现 Word 转 OFD，通常有几种方式：COM 自动化、调用外部工具，或手动解析 .docx 文件。但这些方式往往存在平台限制、环境依赖或实现复杂的问题。

相比之下，Spire.Doc for C++ 提供了一种更直接的实现方式：

• 无需安装 Office：适合服务器环境，部署更简单。
• 跨平台支持：兼容 Windows 和 Linux，适用于容器化应用。
• 高度还原格式：输出的 OFD 文档能准确保留原文档中的表格、图片、页眉页脚和字体样式。
• API 简洁易用：核心转换逻辑非常简练，无需深入了解复杂的文档对象模型。
• 支持多种 Word 格式：包括 DOC、DOCX、DOCM、DOTX 和 DOTM。

虽然它不能覆盖所有极端场景，但对于大多数生产环境需求来说已经足够稳定可靠。

搭建 Spire.Doc for C++ 开发环境

在开始转换之前，请确保开发环境已正确配置。

通过 NuGet 安装

1. 在 Visual Studio 中打开你的项目。
2. 转到工具→ NuGet 包管理器→管理解决方案的 NuGet 程序包...。
3. 搜索 “Spire.Doc.Cpp”。
4. 点击安装。

手动安装

1. 从官网下载最新版 Spire.Doc for C++。
2. 解压安装包。
3. 配置 Visual Studio 项目，添加 Include 目录的路径，并链接 lib 目录。确保 DLL 文件放置在可执行文件所在目录或系统路径下。

详细的安装教程可参考：如何将 Spire.Doc for C++ 集成到 C++ 程序中

基本项目配置

安装完成后，在代码中添加以下内容：

#include "Spire.Doc.o.h"
using namespace Spire::Doc;

基础转换：在 C++ 中将 Word 转为 OFD

项目准备就绪后，只需几行代码即可完成转换。

完整 C++ 示例：

#include "Spire.Doc.o.h"
#include <iostream>

using namespace Spire::Doc;

int main()
{
    // 创建 Document 对象
    Document* document = new Document();

    try {
        // 加载 Word 文档
        document->LoadFromFile(L"C:\\Users\\Desktop\\测试.docx");

        // 将文档转换并保存为 OFD 格式
        document->SaveToFile(L"C:\\Users\\Desktop\\测试.ofd", FileFormat::OFD);

        document->Close();
        std::cout << "转换成功！" << std::endl;
    }
    catch (const std::exception& ex) {
        std::cerr << "错误: " << ex.what() << std::endl;
        delete document;
        return -1;
    }

    delete document;
    return 0;
}

核心代码说明：

• 创建 Document 对象。
• 使用 LoadFromFile() 加载 Word 文件。
• 使用 SaveToFile() 并指定 FileFormat::OFD 完成转换。

进阶：Word 转 OFD 的高级转换设置

除了基础转换，Spire.Doc for C++ 还支持更灵活的控制，例如导出指定页面、调整图片压缩、嵌入字体等。

将指定页面转换为 OFD

有些场景下，你只需要转换文档中的部分页面。以下示例演示了如何提取指定页面并保存为单独的 OFD 文件。

#include "Spire.Doc.o.h"
#include <iostream>

using namespace Spire::Doc;

int main()
{
    // 使用智能指针管理内存
    intrusive_ptr<Document> document = new Document();

    try {
        document->LoadFromFile(L"C:\\Users\\Desktop\\报告.docx");

        // 提取第 2 页（索引从 0 开始，所以第 2 页索引为 1）
        intrusive_ptr<Document> newDoc = document->ExtractPages(1, 1);

        newDoc->SaveToFile(L"C:\\Users\\Desktop\\报告_Partial.ofd", FileFormat::OFD);

        document->Close();
        newDoc->Close();

        std::cout << "第2页转换成功！" << std::endl;
    }
    catch (const std::exception& ex) {
        std::cerr << "错误: " << ex.what() << std::endl;
        return -1;
    }

    return 0;
}

核心代码说明：

• intrusive_ptr 是智能指针，可自动管理内存，防止内存泄漏并简化代码。
• ExtractPages(1, 1)：提取第 2 页（索引从 0 开始）。

自定义 OFD 转换设置

在一些场景中，你可能希望控制输出文件大小或字体显示效果，例如：

#include "Spire.Doc.o.h"
#include <iostream>

using namespace Spire::Doc;

int main()
{
    intrusive_ptr<Document> document = new Document();

    try {
        document->LoadFromFile(L"C:\\Users\\Desktop\\手册.docx");

        // 设置图片压缩质量 (0-100)
        document->SetJPEGQuality(75);

        // 设置嵌入文档中使用的所有字体
        intrusive_ptr<ToPdfParameterList> parameters = new ToPdfParameterList();
        parameters->SetIsEmbeddedAllFonts(true);

        document->SaveToFile(L"C:\\Users\\Desktop\\手册.ofd", FileFormat::OFD);
        document->Close();

        std::cout << "自定义转换成功！" << std::endl;
    }
    catch (const std::exception& ex) {
        std::cerr << "错误: " << ex.what() << std::endl;
        return -1;
    }
    return 0;
}

核心代码说明：

• SetJPEGQuality(75) 设置图片压缩质量（0–100）。
• SetIsEmbeddedAllFonts(true)：嵌入所有字体，避免显示异常。

常见问题 (FAQs)

问题1：需要安装 Microsoft Word 吗？

答：不需要。Spire.Doc for C++ 独立运行，无需依赖 Office。

问题2：如何只转换部分页面？

答：如上文所述，你可以使用 document->ExtractPages() 提取指定页面后再转换，或者将内容复制到新文档中处理。

问题3：为什么转换后的 OFD 字体显示不一致？

答：这通常是因为系统缺少相应字体。建议在保存前调用 SetIsEmbeddedAllFonts(true) 启用字体嵌入。

问题4：如何减小生成的 OFD 文件体积？

答：可以通过 SetJPEGQuality(75) 开启图片压缩或降低图片质量来减小文件大小。

问题5：OFD 和 PDF 有什么区别？

答：OFD 是中国国家标准，主要用于政务系统。PDF 是国际标准。两者都支持固定版式，但 OFD 在中国政务和官方场景中更常见。

结语

对于需要满足中国国家标准、实现可靠文档共享或存档的应用程序来说，实现 C++ Word 转 OFD 至关重要。借助 Spire.Doc for C++，开发者无需依赖 Office 自动化即可完成高效转换。无论是全文转换、指定页面提取还是自定义转换参数设置，该库都提供了一个实用且强大的 C++ 文档处理方案。

如需了解更多文档转换和操作功能，请查阅官方文档。