快速上手

安装

使用 Excelize 要求使用的 Go 语言为 1.10 或更高版本。

  • 安装命令
  1. go get github.com/360EntSecGroup-Skylar/excelize

更新

  • 更新命令
  1. go get -u github.com/360EntSecGroup-Skylar/excelize

创建 Excel 文档

下面是一个创建 Excel 文档的简单例子：

  1. package main
  3. import (
  4.     "fmt"
  6.     "github.com/360EntSecGroup-Skylar/excelize"
  7. )
  9. func main() {
  10.     f := excelize.NewFile()
  11.     // 创建一个工作表
  12.     index := f.NewSheet("Sheet2")
  13.     // 设置单元格的值
  14.     f.SetCellValue("Sheet2", "A2", "Hello world.")
  15.     f.SetCellValue("Sheet1", "B2", 100)
  16.     // 设置工作簿的默认工作表
  17.     f.SetActiveSheet(index)
  18.     // 根据指定路径保存文件
  19.     err := f.SaveAs("./Book1.xlsx")
  20.     if err != nil {
  21.         fmt.Println(err)
  22.     }
  23. }

读取 Excel 文档

下面是读取 Excel 文档的例子：

  1. package main
  3. import (
  4.     "fmt"
  6.     "github.com/360EntSecGroup-Skylar/excelize"
  7. )
  9. func main() {
  10.     f, err := excelize.OpenFile("./Book1.xlsx")
  11.     if err != nil {
  12.         fmt.Println(err)
  13.         return
  14.     }
  15.     // 获取工作表中指定单元格的值
  16.     cell, err := f.GetCellValue("Sheet1", "B2")
  17.     if err != nil {
  18.         fmt.Println(err)
  19.         return
  20.     }
  21.     fmt.Println(cell)
  22.     // 获取 Sheet1 上所有单元格
  23.     rows, err := f.GetRows("Sheet1")
  24.     for _, row := range rows {
  25.         for _, colCell := range row {
  26.             fmt.Print(colCell, "\t")
  27.         }
  28.         fmt.Println()
  29.     }
  30. }

在 Excel 文档中创建图表

使用 Excelize 生成图表十分简单，仅需几行代码。您可以根据工作表中的已有数据构建图表，或向工作表中添加数据并创建图表。

在 Excel 文档中创建图表

  1. package main
  3. import (
  4.     "fmt"
  6.     "github.com/360EntSecGroup-Skylar/excelize"
  7. )
  9. func main() {
  10.     categories := map[string]string{"A2": "Small", "A3": "Normal", "A4": "Large", "B1": "Apple", "C1": "Orange", "D1": "Pear"}
  11.     values := map[string]int{"B2": 2, "C2": 3, "D2": 3, "B3": 5, "C3": 2, "D3": 4, "B4": 6, "C4": 7, "D4": 8}
  12.     f := excelize.NewFile()
  13.     for k, v := range categories {
  14.         f.SetCellValue("Sheet1", k, v)
  15.     }
  16.     for k, v := range values {
  17.         f.SetCellValue("Sheet1", k, v)
  18.     }
  19.     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"}}`)
  20.     if err != nil {
  21.         fmt.Println(err)
  22.     }
  23.     // 根据指定路径保存文件
  24.     err = f.SaveAs("./Book1.xlsx")
  25.     if err != nil {
  26.         fmt.Println(err)
  27.     }
  28. }

向 Excel 文档中插入图片

  1. package main
  3. import (
  4.     "fmt"
  5.     _ "image/gif"
  6.     _ "image/jpeg"
  7.     _ "image/png"
  9.     "github.com/360EntSecGroup-Skylar/excelize"
  10. )
  12. func main() {
  13.     f, err := excelize.OpenFile("./Book1.xlsx")
  14.     if err != nil {
  15.         fmt.Println(err)
  16.         return
  17.     }
  18.     // 插入图片
  19.     err = f.AddPicture("Sheet1", "A2", "./image1.png", "")
  20.     if err != nil {
  21.         fmt.Println(err)
  22.     }
  23.     // 在工作表中插入图片，并设置图片的缩放比例
  24.     err = f.AddPicture("Sheet1", "D2", "./image2.jpg", `{"x_scale": 0.5, "y_scale": 0.5}`)
  25.     if err != nil {
  26.         fmt.Println(err)
  27.     }
  28.     // 在工作表中插入图片，并设置图片的打印属性
  29.     err = f.AddPicture("Sheet1", "H2", "./image3.gif", `{"x_offset": 15, "y_offset": 10, "print_obj": true, "lock_aspect_ratio": false, "locked": false}`)
  30.     if err != nil {
  31.         fmt.Println(err)
  32.     }
  33.     // 保存文件
  34.     err = f.Save()
  35.     if err != nil {
  36.         fmt.Println(err)
  37.     }
  38. }