unioffice 开源项目使用教程

1. 项目介绍

unioffice 是一个纯 Go 语言编写的库，用于创建和处理 Office Open XML 文档（.docx、.xlsx 和 .pptx）。其目标是成为最兼容、性能最高的 Go 库，用于创建和编辑 docx/xlsx/pptx 文件。

2. 项目快速启动

首先，确保你已经安装了 Go 开发环境。接下来，使用以下命令克隆项目并安装依赖：

go get github.com/unidoc/unioffice/v2

创建一个简单的 Word 文档

以下是一个创建简单 Word 文档的示例代码：

package main

import (
	"log"
	"os"

	"github.com/unidoc/unioffice/v2/document"
	"github.com/unidoc/unioffice/v2/types"
)

func main() {
	doc := document.New()
	para := doc.AddParagraph()
	run := para.AddRun()
	run.Text("Hello, World!")

	err := doc.SaveToFile("hello_world.docx")
	if err != nil {
		log.Fatalf("error saving document: %s", err)
	}

	log.Println("Document created successfully: hello_world.docx")
}

创建一个简单的 Excel 文档

以下是一个创建简单 Excel 文档的示例代码：

package main

import (
	"log"
	"os"

	"github.com/unidoc/unioffice/v2/spreadsheet"
)

func main() {
	sheet := spreadsheet.New()
	sheet.AddRow().AddCell().SetString("Hello")
	sheet.AddRow().AddCell().SetString("World")

	err := sheet.SaveToFile("hello_world.xlsx")
	if err != nil {
		log.Fatalf("error saving spreadsheet: %s", err)
	}

	log.Println("Spreadsheet created successfully: hello_world.xlsx")
}

创建一个简单的 PowerPoint 文档

以下是一个创建简单 PowerPoint 文档的示例代码：

package main

import (
	"log"
	"os"

	"github.com/unidoc/unioffice/v2/presentation"
)

func main() {
 preso := presentation.New()
	slide := preso.AddSlide()

_shape := slide.AddShape()
_shape.SetPosition(100, 100)
_shape.SetSize(200, 50)
_shape.TextFrame().AddRun().SetText("Hello, World!")

	err := preso.SaveToFile("hello_world.pptx")
	if err != nil {
		log.Fatalf("error saving presentation: %s", err)
	}

	log.Println("Presentation created successfully: hello_world.pptx")
}

3. 应用案例和最佳实践

使用模板创建文档

unioffice 支持使用现有文档作为模板，以便重用文档中的样式。以下是一个使用模板创建 Word 文档的示例：

package main

import (
	"log"
	"os"

	"github.com/unidoc/unioffice/v2/document"
)

func main() {
	// 加载模板文档
	templateDoc, err := document.LoadFromFile("template.docx")
	if err != nil {
		log.Fatalf("error loading template: %s", err)
	}

	// 使用模板创建新文档
	newDoc := templateDoc.Copy()

	// 添加内容
	para := newDoc.AddParagraph()
	para.AddRun().SetText("这是使用模板创建的文档。")

	// 保存新文档
	err = newDoc.SaveToFile("new_document.docx")
	if err != nil {
		log.Fatalf("error saving new document: %s", err)
	}

	log.Println("Document created successfully using template: new_document.docx")
}

条件格式化

unioffice 支持对 Excel 单元格进行条件格式化。以下是一个设置条件格式化的示例：

package main

import (
	"log"
	"os"

	"github.com/unidoc/unioffice/v2/spreadsheet"
)

func main() {
	sheet := spreadsheet.New()
	sheet.AddRow().AddCell().SetString("A").SetConditionalFormatting(">=1", "fill", "red")
	sheet.AddRow().AddCell().SetString("B").SetConditionalFormatting("<=1", "fill", "green")

	err := sheet.SaveToFile("conditional_formatting.xlsx")
	if err != nil {
		log.Fatalf("error saving spreadsheet: %s", err)
	}

	log.Println("Spreadsheet created successfully with conditional formatting: conditional_formatting.xlsx")
}

4. 典型生态项目

目前，unioffice 社区已经有许多典型的生态项目，例如：

• docx2pdf：将 docx 文档转换为 pdf 文件。
• excelize：一个用于操作 Excel 文件的 Go 库。
• go-pptx：另一个用于处理 PowerPoint 文件的 Go 库。

这些项目可以帮助开发者更方便地处理 Office 文档，提高工作效率。