Excelize是一个用Go语言编写的库,它提供了一组函数,允许读写XLAM、XLSM、XLSX、XLTM、XLTX文件。这个库支持读取和写入由Microsoft Excel™ 2007及以后版本生成的电子表格文档。它支持复杂组件的高兼容性,并提供了流式API,用于从具有大量数据的工作表生成或读取数据。要使用这个库,Go版本需要1.15或更高。完整的API文档可以通过Go的内置文档工具查看,或者在线查看文档参考。
要开始使用Excelize,可以通过Go的包管理器来安装它。在终端中输入以下命令:
go get github.com/xuri/excelize/v2
这将安装Excelize库的最新版本。
以下是一个创建XLSX文件的最小示例:
package main
import (
"github.com/xuri/excelize/v2"
)
func main() {
f := excelize.NewFile()
index := f.NewSheet("Sheet2")
f.SetCellValue("Sheet2", "A2", "Hello world.")
f.SetCellValue("Sheet1", "B2", 100)
f.SetActiveSheet(index)
if err := f.SaveAs("Book1.xlsx"); err != nil {
println(err.Error())
}
}
这段代码创建了一个新的Excel文件,其中包含两个工作表,并在工作表"Sheet2"的A2单元格中写入了"Hello world.",在工作表"Sheet1"的B2单元格中写入了100。然后,它将"Sheet2"设置为活动工作表,并保存文件。
以下是读取XLSX文档的基本代码:
package main
import (
"github.com/360EntSecGroup-Skylar/excelize"
)
func main() {
f, err := excelize.OpenFile("Book1.xlsx")
if err != nil {
println(err.Error())
return
}
cell, err := f.GetCellValue("Sheet1", "B2")
if err != nil {
println(err.Error())
return
}
println(cell)
rows, err := f.GetRows("Sheet1")
for _, row := range rows {
for _, colCell := range row {
print(colCell, "\t")
}
println()
}
}
这段代码打开了一个名为"Book1.xlsx"的Excel文件,读取了"Sheet1"工作表中B2单元格的值,并打印出来。然后,它遍历"Sheet1"的所有行,并打印出每一行的单元格值。
使用Excelize,生成和管理图表就像几行代码一样简单。可以基于工作表中的数据构建图表,或者在没有任何数据的工作表中生成图表。
package main
import (
"github.com/xuri/excelize/v2"
)
func main() {
categories := map[string]string{
"A2": "Small",
"A3": "Normal",
"A4": "Large",
"B1": "Apple",
"C1": "Orange",
"D1": "Pear",
}
values := map[string]int{
"B2": 2,
"C2": 3,
"D2": 3,
"B3": 5,
"C3": 2,
"D3": 4,
"B4": 6,
"C4": 7,
"D4": 8,
}
f := excelize.NewFile()
for k, v := range categories {
f.SetCellValue("Sheet1", k, v)
}
for k, v := range values {
f.SetCellValue("Sheet1", k, v)
}
if err := f.AddChart("Sheet1", "E1", `{
"type": "col3DClustered",
"series":[{"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"}],
"title": {"name": "Fruit 3D Clustered Column Chart"}
}`); err != nil {
println(err.Error())
return
}
if err := f.SaveAs("Book1.xlsx"); err != nil {
println(err.Error())
}
}
这段代码在"Sheet1"中添加了一个3D柱状图。它首先定义了图表的类别和值,然后在工作表中设置这些值。接着,它添加了一个图表,并将文件保存为"Book1.xlsx"。
向Excel文件添加图片也很简单。可以插入图片,并设置缩放比例、偏移量等属性。
package main
import (
_ "image/gif"
_ "image/jpeg"
_ "image/png"
"github.com/xuri/excelize/v2"
)
func main() {
f, err := excelize.OpenFile("Book1.xlsx")
if err != nil {
println(err.Error())
return
}
if err := f.AddPicture("Sheet1", "A2", "image.png", ""); err != nil {
println(err.Error())
}
if err := f.AddPicture("Sheet1", "D2", "image.jpg", `{"x_scale": 0.5, "y_scale": 0.5}`); err != nil {
println(err.Error())
}
if err := f.AddPicture("Sheet1", "H2", "image.gif", `{"x_offset": 15, "y_offset": 10, "print_obj": true, "lock_aspect_ratio": false, "locked": false}`); err != nil {
println(err.Error())
}
if err = f.Save(); err != nil {
println(err.Error())
}
}
这段代码打开了一个名为"Book1.xlsx"的Excel文件,并在"Sheet1"中添加了三张图片。第一张图片没有设置任何特殊属性,第二张图片设置了缩放比例,第三张图片设置了偏移量、打印支持、锁定宽高比和锁定状态。最后,它保存了文件。