ExcelizeGo 語(yǔ)言(golang) Excel (xlsx) 電子表格文檔基礎(chǔ)庫(kù)

Excelize 是 Go 語(yǔ)言編寫(xiě)的用于操作 Office Excel 文檔基礎(chǔ)庫(kù)，基于 ECMA-376，ISO/IEC 29500 國(guó)際標(biāo)準(zhǔn)?？梢允褂盟鼇?lái)讀取、寫(xiě)入由 Microsoft Excel? 2007 及以上版本創(chuàng)建的電子表格文檔。支持 XLSX / XLSM / XLTM 等多種文檔格式，高度兼容帶有樣式、圖片(表)、透視表、切片器等復(fù)雜組件的文檔，并提供流式讀寫(xiě) API，用于處理包含大規(guī)模數(shù)據(jù)的工作簿?？蓱?yīng)用于各類(lèi)報(bào)表平臺(tái)、云計(jì)算、邊緣計(jì)算等系統(tǒng)。入選 2020 Gopher China - Go 領(lǐng)域明星開(kāi)源項(xiàng)目 (GSP)、2018 開(kāi)源中國(guó)碼云 Gitee 最有價(jià)值開(kāi)源項(xiàng)目 GVP，目前已成為 Go 語(yǔ)言最受歡迎的 Excel 文檔基礎(chǔ)庫(kù)。

知名用戶

安裝

go get github.com/xuri/excelize

• 如果您使用 Go Modules 管理軟件包，請(qǐng)使用下面的命令來(lái)安裝最新版本。

go get github.com/xuri/excelize/v2

創(chuàng)建 Excel 文檔

下面是一個(gè)創(chuàng)建 Excel 文檔的簡(jiǎn)單例子：

package main

import (
    "fmt"

    "github.com/xuri/excelize/v2"
)

func main() {
    f := excelize.NewFile()
    defer func() {
        if err := f.Close(); err != nil {
            fmt.Println(err)
        }
    }()
    // 創(chuàng)建一個(gè)工作表
    index, err := f.NewSheet("Sheet2")
    if err != nil {
        fmt.Println(err)
        return
    }
    // 設(shè)置單元格的值
    f.SetCellValue("Sheet2", "A2", "Hello world.")
    f.SetCellValue("Sheet1", "B2", 100)
    // 設(shè)置工作簿的默認(rèn)工作表
    f.SetActiveSheet(index)
    // 根據(jù)指定路徑保存文件
    if err := f.SaveAs("Book1.xlsx"); err != nil {
        fmt.Println(err)
    }
}

讀取 Excel 文檔

下面是讀取 Excel 文檔的例子：

package main

import (
    "fmt"

    "github.com/xuri/excelize/v2"
)

func main() {
    f, err := excelize.OpenFile("Book1.xlsx")
    if err != nil {
        fmt.Println(err)
        return
    }
    defer func() {
        // 關(guān)閉工作簿
        if err := f.Close(); err != nil {
            fmt.Println(err)
        }
    }()
    // 獲取工作表中指定單元格的值
    cell, err := f.GetCellValue("Sheet1", "B2")
    if err != nil {
        fmt.Println(err)
        return
    }
    fmt.Println(cell)
    // 獲取 Sheet1 上所有單元格
    rows, err := f.GetRows("Sheet1")
    if err != nil {
        fmt.Println(err)
        return
    }
    for _, row := range rows {
        for _, colCell := range row {
            fmt.Print(colCell, "\t")
        }
        fmt.Println()
    }
}

在 Excel 文檔中創(chuàng)建圖表

使用 Excelize 生成圖表十分簡(jiǎn)單，僅需幾行代碼。您可以根據(jù)工作表中的已有數(shù)據(jù)構(gòu)建圖表，或向工作表中添加數(shù)據(jù)并創(chuàng)建圖表。

package main

import (
    "fmt"

    "github.com/xuri/excelize/v2"
)

func main() {
    f := excelize.NewFile()
    defer func() {
        if err := f.Close(); err != nil {
            fmt.Println(err)
        }
    }()
    for idx, row := range [][]interface{}{
        {nil, "Apple", "Orange", "Pear"}, {"Small", 2, 3, 3},
        {"Normal", 5, 2, 4}, {"Large", 6, 7, 8},
    } {
        cell, err := excelize.CoordinatesToCellName(1, idx+1)
        if err != nil {
            fmt.Println(err)
            return
        }
        f.SetSheetRow("Sheet1", cell, &row)
    }
    if err := f.AddChart("Sheet1", "E1", &excelize.Chart{
        Type: "col3DClustered",
        Series: []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",
            }},
        Title: excelize.ChartTitle{
            Name: "Fruit 3D Clustered Column Chart",
        },
    }); err != nil {
        fmt.Println(err)
        return
    }
    // 根據(jù)指定路徑保存文件
    if err := f.SaveAs("Book1.xlsx"); err != nil {
        fmt.Println(err)
    }
}

向 Excel 文檔中插入圖片

package main

import (
    "fmt"
    _ "image/gif"
    _ "image/jpeg"
    _ "image/png"

    "github.com/xuri/excelize/v2"
)

func main() {
    f, err := excelize.OpenFile("Book1.xlsx")
    if err != nil {
        fmt.Println(err)
        return
    }
    defer func() {
        // 關(guān)閉工作簿
        if err := f.Close(); err != nil {
            fmt.Println(err)
        }
    }()
    // 插入圖片
    if err := f.AddPicture("Sheet1", "A2", "image.png", nil); err != nil {
        fmt.Println(err)
    }
    // 在工作表中插入圖片，并設(shè)置圖片的縮放比例
    if err := f.AddPicture("Sheet1", "D2", "image.jpg",
        &excelize.GraphicOptions{ScaleX: 0.5, ScaleY: 0.5}); err != nil {
        fmt.Println(err)
    }
    // 在工作表中插入圖片，并設(shè)置圖片的打印屬性
    enable, disable := true, false
    if err := f.AddPicture("Sheet1", "H2", "image.gif",
        &excelize.GraphicOptions{
            PrintObject:     &enable,
            LockAspectRatio: false,
            OffsetX:         15,
            OffsetY:         10,
            Locked:          &disable,
        }); err != nil {
        fmt.Println(err)
    }
    // 保存工作簿
    if err = f.Save(); err != nil {
        fmt.Println(err)
    }
}