快速开始

这是 /zh-CN/ 文档树下的中文快速开始页。

安装与构建

cmake -S . -B build
cmake --build build
cmake --install build --prefix install

顶层构建默认启用 BUILD_CLI，因此会构建 featherdoc_cli。如果只需要库， 可以显式传入 -DBUILD_CLI=OFF。

PDF 支持仍是实验性、显式开启的能力。只有在需要 PDF 工作流页面和 CLI 入口时， 才构建 FEATHERDOC_BUILD_PDF 和 FEATHERDOC_BUILD_PDF_IMPORT。

安装后的 CMake 消费方应显式请求 Word/Core 组件：

find_package(FeatherDoc CONFIG REQUIRED COMPONENTS Core)
target_link_libraries(my_app PRIVATE FeatherDoc::Core)

Word 是 Core 的等价组件名。启用 PDF writer 且 FreeType、ZLIB、PNG 与可选的 HarfBuzz 都来自可发现的 CMake package 时，安装包还会导出 Pdf 组件：

find_package(FeatherDoc CONFIG REQUIRED COMPONENTS Core Pdf)
target_link_libraries(my_app PRIVATE FeatherDoc::Pdf)

消费 Pdf 时应使用与 FeatherDoc 构建时一致的依赖环境或 toolchain。只请求 Core / Word 不会查找任何 PDF 依赖。使用仓库内 fallback 依赖构建时，PDF writer 仍只在构建树可用；请求未安装的 Pdf 或 PdfImport 会在配置阶段明确 失败，不会出现只有头文件却没有可链接实现的假可用状态。

最小 C++ 用法

#include <featherdoc.hpp>

int main() {
    featherdoc::Document doc{"input.docx"};
    if (doc.open()) {
        return 1;
    }

    doc.paragraphs().add_run("Generated by FeatherDoc");
    return doc.save_as("output.docx") ? 1 : 0;
}

下一步阅读

• Document：了解 Document 如何打开、保存、检查和修改文档。

• Word 文档处理工作流：按任务阅读 Word 文档生成、填充、审阅和批量编辑流程。

• Paragraph 和 Run：查看段落与 run API。

• Table、TableRow 和 TableCell：查看表格、行和单元格 API。

• TemplatePart：查看书签、内容控件、模板槽位和 schema 校验 API。

• PDF 工作流：查看实验性 PDF 导入导出工作流。