快捷導(dǎo)航

Golang生成Excel文檔的方法步驟

更新時(shí)間：2021年06月09日 10:08:14 作者：K8sCat

生成Excel是一個(gè)很常見(jiàn)的需求，本文將介紹如何使用Go的 Excelize庫(kù)去生成Excel文檔，以及一些具體場(chǎng)景下的代碼實(shí)現(xiàn)，感興趣的可以參考一下

關(guān)于 Excelize 庫(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 / XLTX 等多種文檔格式，高度兼容帶有樣式、圖片(表)、透視表、切片器等復(fù)雜組件的文檔，并提供流式讀寫(xiě) API，用于處理包含大規(guī)模數(shù)據(jù)的工作簿?？蓱?yīng)用于各類(lèi)報(bào)表平臺(tái)、云計(jì)算、邊緣計(jì)算等系統(tǒng)。使用本類(lèi)庫(kù)要求使用的 Go 語(yǔ)言為 1.15 或更高版本。

性能對(duì)比

下圖是一些主要的開(kāi)源 Excel 庫(kù)在生成 12800*50 純文本矩陣時(shí)的性能對(duì)比（OS: macOS Mojave version 10.14.4, CPU: 3.4 GHz Intel Core i5, RAM: 16 GB 2400 MHz DDR4, HDD: 1 TB），包括 Go、Python、Java、PHP 和 NodeJS。

安裝

最新的版本是 v2.4.0：

go get github.com/360EntSecGroup-Skylar/excelize/v2

創(chuàng)建 Excel 文檔

下面的案例中，我們創(chuàng)建了一個(gè) Excel 文檔，并使用 NewSheet 方法新建了一個(gè) Sheet2 工作表，Sheet1 是默認(rèn)創(chuàng)建的工作表，然后我們使用 SetCellValue 方法分別在 Sheet2 工作表的 A2 單元格和 Sheet1 表格的 B2 單元格設(shè)置值，并通過(guò)使用 SetActiveSheet 方法設(shè)置 Sheet2 工作表為默認(rèn)的工作表，最終調(diào)用 SaveAs 方法將數(shù)據(jù)寫(xiě)入 Excel 文檔中：

package main

import (
    "fmt"

    "github.com/360EntSecGroup-Skylar/excelize/v2"
)

func main() {
    f := excelize.NewFile()
    // 創(chuàng)建一個(gè)工作表
    index := f.NewSheet("Sheet2")
    // 設(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)
    }
}

實(shí)際場(chǎng)景復(fù)現(xiàn)

創(chuàng)建工作表

工作表名稱(chēng)是大小寫(xiě)敏感的：

index := f.NewSheet("Sheet2")

刪除默認(rèn)創(chuàng)建的工作表

默認(rèn)創(chuàng)建的 Excel 文檔是包含一個(gè)名為 Sheet1 的工作表，我們可能并不需要這個(gè)默認(rèn)工作表，這個(gè)時(shí)候我們可以刪除這個(gè)工作表：

f.DeleteSheet("Sheet1")

合并單元格

合并 Sheet1 工作表上 F1:I2 區(qū)域內(nèi)的單元格：

excel.MergeCell("Sheet1", "F1", "I2")

單元格樣式

給單元格設(shè)置樣式會(huì)經(jīng)常遇到，比如設(shè)置單元格的背景顏色，Excelize 庫(kù)提供下面兩個(gè)方法進(jìn)行設(shè)置單元格樣式（NewStyle 和 SetCellStyle）：

// 通過(guò)給定的樣式格式 JSON 或結(jié)構(gòu)體的指針創(chuàng)建樣式并返回樣式索引。
// 請(qǐng)注意，顏色需要使用 RGB 色域代碼表示。
style, err := f.NewStyle(`{
    "border": [
    {
        "type": "left",
        "color": "0000FF",
        "style": 3
    },
    {
        "type": "top",
        "color": "00FF00",
        "style": 4
    },
    {
        "type": "bottom",
        "color": "FFFF00",
        "style": 5
    },
    {
        "type": "right",
        "color": "FF0000",
        "style": 6
    },
    {
        "type": "diagonalDown",
        "color": "A020F0",
        "style": 7
    },
    {
        "type": "diagonalUp",
        "color": "A020F0",
        "style": 8
    }]
}`)
if err != nil {
    fmt.Println(err)
}
err = f.SetCellStyle("Sheet1", "D7", "D7", style)

文字水平居中

文字水平居中需要用到 Alignment 樣式結(jié)構(gòu)體：

type Alignment struct {
    Horizontal      string `json:"horizontal"`
    Indent          int    `json:"indent"`
    JustifyLastLine bool   `json:"justify_last_line"`
    ReadingOrder    uint64 `json:"reading_order"`
    RelativeIndent  int    `json:"relative_indent"`
    ShrinkToFit     bool   `json:"shrink_to_fit"`
    TextRotation    int    `json:"text_rotation"`
    Vertical        string `json:"vertical"`
    WrapText        bool   `json:"wrap_text"`
}

水平居中只要設(shè)置 Horizontal 的值為 center 即可：

style, err := f.NewStyle(`{"alignment":{"horizontal":"center"}}`)
if err != nil {
    fmt.Println(err)
}
err = excel.SetCellStyle("Sheet1", "B1", "B1", style)

給單元格設(shè)置純色填充

給單元格填充顏色會(huì)使用到 Fill 樣式結(jié)構(gòu)體：

type Fill struct {
    Type    string   `json:"type"`
    Pattern int      `json:"pattern"`
    Color   []string `json:"color"`
    Shading int      `json:"shading"`
}

Style 結(jié)構(gòu)體

從上面設(shè)置樣式的代碼中，我們可以發(fā)現(xiàn) border 是一個(gè)數(shù)組，而 alignment 是一個(gè)結(jié)構(gòu)體，這是由 Style 結(jié)構(gòu)體決定的：

type Style struct {
    Border        []Border    `json:"border"`
    Fill          Fill        `json:"fill"`
    Font          *Font       `json:"font"`
    Alignment     *Alignment  `json:"alignment"`
    Protection    *Protection `json:"protection"`
    NumFmt        int         `json:"number_format"`
    DecimalPlaces int         `json:"decimal_places"`
    CustomNumFmt  *string     `json:"custom_number_format"`
    Lang          string      `json:"lang"`
    NegRed        bool        `json:"negred"`
}