快速开始

安装

使用最新版本 Excelize 要求您使用的 Go 语言为 1.15 或更高版本。

  • 安装命令
  1. go get github.com/360EntSecGroup-Skylar/excelize
  • 如果您使用 Go Modules 管理软件包,请使用下面的命令来安装最新版本。
  1. go get github.com/360EntSecGroup-Skylar/excelize/v2

更新

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

创建 Excel 文档

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

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

读取 Excel 文档

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

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

在 Excel 文档中创建图表

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

在 Excel 文档中创建图表

  1. package main
  2. import(
  3. "fmt"
  4. "github.com/360EntSecGroup-Skylar/excelize/v2"
  5. )
  6. func main(){
  7. categories := map[string]string{
  8. "A2":"Small","A3":"Normal","A4":"Large","B1":"Apple","C1":"Orange","D1":"Pear"}
  9. values := map[string]int{
  10. "B2":2,"C2":3,"D2":3,"B3":5,"C3":2,"D3":4,"B4":6,"C4":7,"D4":8}
  11. f := excelize.NewFile()
  12. for k, v := range categories {
  13. f.SetCellValue("Sheet1", k, v)
  14. }
  15. for k, v := range values {
  16. f.SetCellValue("Sheet1", k, v)
  17. }
  18. if err := f.AddChart("Sheet1","E1",`{
  19. "type": "col3DClustered",
  20. "series": [
  21. {
  22. "name": "Sheet1!$A$2",
  23. "categories": "Sheet1!$B$1:$D$1",
  24. "values": "Sheet1!$B$2:$D$2"
  25. },
  26. {
  27. "name": "Sheet1!$A$3",
  28. "categories": "Sheet1!$B$1:$D$1",
  29. "values": "Sheet1!$B$3:$D$3"
  30. },
  31. {
  32. "name": "Sheet1!$A$4",
  33. "categories": "Sheet1!$B$1:$D$1",
  34. "values": "Sheet1!$B$4:$D$4"
  35. }],
  36. "title":
  37. {
  38. "name": "Fruit 3D Clustered Column Chart"
  39. }
  40. }`); err !=nil{
  41. fmt.Println(err)
  42. return
  43. }
  44. // 根据指定路径保存文件
  45. if err := f.SaveAs("Book1.xlsx"); err !=nil{
  46. fmt.Println(err)
  47. }
  48. }

向 Excel 文档中插入图片

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