Excelize 库使用指南

Excelize 库使用指南

excelizeGo language library for reading and writing Microsoft Excel™ (XLAM / XLSM / XLSX / XLTM / XLTX) spreadsheets项目地址:https://gitcode.com/gh_mirrors/ex/excelize

1. 项目介绍

Excelize 是一个纯 Go 语言编写的库，用于读写 Microsoft Excel™ 的文件格式（XLAM / XLSM / XLSX / XLTM / XLTX）。它支持从 2007 年版及以后版本的 Excel 生成的电子表格文档。此库提供了高度兼容的功能，并且具有流式 API，适合处理大量数据时生成或读取工作表。

2. 项目快速启动

安装

确保你的 Go 环境是 1.18 或更高版本。要安装 Excelize 库，运行以下命令：

go get github.com/xuri/excelize/v2

创建电子表格

下面是一个简单的示例，创建一个新的电子表格文件：

package main

import (
	"fmt"
	"github.com/xuri/excelize/v2"
)

func main() {
	f := excelize.NewFile()
	defer func() {
		if err := f.SaveAs("Book1.xlsx"); err != nil {
			fmt.Println(err)
		}
	}()
}

上述代码将创建一个名为 Book1.xlsx 的新电子表格文件。

3. 应用案例和最佳实践

添加数据到工作表

func main() {
	// ...
	for i := 0; i < 5; i++ {
		cellName, _ := excelize.CoordinatesToCellName(1, i+1)
		f.SetCellValue("Sheet1", cellName, fmt.Sprintf("Value %d", i+1))
	}
}

添加图表

typeData := [][]interface{}{
	{"Fruit", "Apples", "Oranges", "Bananas", "Grapes"},
	{20, 30, 40, 50, 60},
}

// 设置数据
for row, data := range typeData {
	for col, value := range data {
		cellName, _ := excelize.CoordinatesToCellName(col+1, row+1)
		f.SetCellValue("Sheet1", cellName, value)
	}
}

chart, err := f.AddChart("Sheet1", "E1", *excelize.NewChart(
	excelize.ChartTypeCol3DClustered,
	[]excelize.ChartSeries{
		{Name: "Sheet1!$A$2", Categories: "Sheet1!$B$1:$D$1", Values: "Sheet1!$B$2:$D$2"},
		{Name: "Sheet1!$A$3", Categories: "Sheet1!$B$1:$D$1", Values: "Sheet1!$B$3:$D$3"},
		{Name: "Sheet1!$A$4", Categories: "Sheet1!$B$1:$D$1", Values: "Sheet1!$B$4:$D$4"},
	},
	excelize.ChartTitle{
		Text: "Fruit 3D Clustered Column Chart",
	},
))

if err != nil {
	fmt.Println(err)
	return
}
chart.SetPosition("Sheet1!", "E1")

这个例子展示了如何设置数据并添加一个柱状图到工作表。

4. 典型生态项目

在 Go 生态中，Excelize 被广泛用于处理 Excel 数据的相关场景，例如数据分析、报表生成等。一些相关的项目包括：

• Go-CSV: 用于 CSV 文件的读写操作。
• Go-Pandas: 提供类似 Python Pandas 库的数据分析功能。
• **Gorm`: Go 语言中的 ORM 框架，可以结合 Excelize 实现数据库与 Excel 文件之间的数据交互。

以上仅是一些可能与 Excelize 配合使用的项目，具体使用取决于你的应用场景。

注意: 本教程基于项目仓库提供的信息，确保查看官方文档获取最新更新和详细信息。

excelizeGo language library for reading and writing Microsoft Excel™ (XLAM / XLSM / XLSX / XLTM / XLTX) spreadsheets项目地址:https://gitcode.com/gh_mirrors/ex/excelize