LuBan.Office 2026.9.2.1

English | 中文

LuBan.Office

作者: yswenli | 联系邮箱: yswenli@outlook.com | 代码仓库: https://github.com/yswenli/luban-framework

Office 文档自动化 —— PPT、Word、PDF 的创建、编辑与格式转换，一行代码完成。

Related Projects: LuBan.Framework | LuBan.Common | LuBan.PdfKit | LuBan.Web.Core

为什么选择 LuBan.Office？

在企业级应用中，经常需要自动化生成 PPT 报告、批量替换 Word 模板内容、将文档转为 PDF。手动操作 Office 既低效又不可扩展。

LuBan.Office 提供了面向对象的文档操作 API：

• PptDocument：创建/打开 PPT，操作幻灯片、形状、文本、图片、表格、视频
• WordDocument：文本替换、书签填充、表格操作、插入图片、导出 PDF
• PdfDocument：文本替换、图片替换、HTML/URL 转 PDF
• 统一的许可证管理
• 支持从 HTML、PDF 等格式加载 PPT

注意：LuBan.Office 仅支持 Windows 平台。

快速预览

// PPT：打开模板并替换内容
using var ppt = PptDocument.Load("template.pptx");
PptDocument.ReplaceText(ppt, 0, new[] { ("{{标题}}", "月度报告"), ("{{日期}}", "2026-07") });
PptDocument.ReplaceTableText(ppt, 1, new[] { ("{{姓名}}", "张三"), ("{{成绩}}", "95") });
PptDocument.ReplaceImage(ppt, 2, "photo.jpg", "{{照片}}", deletionFile);
ppt.Save("output.pptx");

// Word：模板填充
using var word = new WordDocument("template.docx");
word.ReplaceText("{{公司名}}", "LuBan 科技");
word.ReplaceTextWithImage("{{印章}}", "seal.png");
word.ReplaceTextWithBookmark(new { Name = "张三", Age = 30 });
word.ExportToPdf("output.pdf");

// PDF：文本替换
using var pdf = new PdfDocument("document.pdf");
pdf.ReplaceText("旧文本", "新文本");
pdf.ReplacePicture("new-image.png", pageIndex: 1);
pdf.Save("output.pdf");

安装

dotnet add package LuBan.Office

功能概览

PptDocument（PPT 操作）

PptSlide（幻灯片操作）

WordDocument（Word 操作）

PdfDocument（PDF 操作）

详细用法

PPT 模板批量生成

using var ppt = PptDocument.Load("template.pptx");

// 第 0 页替换标题和日期
PptDocument.ReplaceText(ppt, 0, new[]
{
    ("{{标题}}", "2026年Q2季度报告"),
    ("{{日期}}", "2026-07-11")
});

// 第 1 页替换表格数据
PptDocument.ReplaceTableText(ppt, 1, new[]
{
    ("{{姓名}}", "张三"),
    ("{{部门}}", "技术部"),
    ("{{业绩}}", "150%")
});

// 第 2 页替换照片（按 alt 文本定位）
PptDocument.ReplaceImage(ppt, 2, "zhangsan.jpg", "{{照片}}", deletionFile);

ppt.Save("report_q2.pptx");

Word 书签填充

public class ContractData
{
    public string PartyA { get; set; } = "LuBan 科技";
    public string PartyB { get; set; } = "合作方";
    public string Amount { get; set; } = "100,000";
    public bool IsConfidential { get; set; } = true;
}

using var word = new WordDocument("contract_template.docx");
word.ReplaceTextWithBookmark(new ContractData());
word.Save("contract_filled.docx");

使用提示

• 平台限制：LuBan.Office 仅支持 Windows 平台（SupportedOSPlatform("windows")）
• 许可证文件需放置在 Libs/ 目录下，程序启动时自动加载
• PPT 中通过 AlternativeText（替代文本）定位形状，建议在模板中预先设置好 alt 文本
• PptDocument 实现了 IDisposable，Dispose 时会自动调用 Save()
• Word 的 ReplaceTextWithImage 支持正则表达式匹配
• 书签填充时，bool 类型属性会自动插入复选框

许可证

Copyright (c) yswenli. All rights reserved.