如何使用?Go?和?Excelize?構(gòu)建電子表格

更新時間：2022年09月30日 11:29:02 作者：pxr007

這篇文章主要介紹了如何使用Go和Excelize構(gòu)建電子表格，文章圍繞主題展開詳細的內(nèi)容介紹，具有一定的參考價值，需要的小伙伴可以參考一下

前言

分析任何規(guī)模的數(shù)據(jù)的重要性怎么強調(diào)都不為過。我們?nèi)粘Ｉ畹膸缀趺總€部分都是數(shù)據(jù)驅(qū)動的，作為開發(fā)人員，在構(gòu)建任何合理大小的應(yīng)用程序時，首要考慮的因素之一是使用什么數(shù)據(jù)庫以及如何構(gòu)建數(shù)據(jù)。

但是，它不僅限于存儲數(shù)據(jù)，您還需要通過提取并以任何非技術(shù)人員都能理解的格式呈現(xiàn)這些數(shù)據(jù)來理解這些數(shù)據(jù)。例如，電子商務(wù)企業(yè)每天都會產(chǎn)生大量數(shù)據(jù)，這意味著我們需要跟蹤產(chǎn)品庫存、月收入、財務(wù)報表等信息。目前，有許多服務(wù)提供這些類型的解決方案，但快速提取和呈現(xiàn)數(shù)據(jù)的最簡單方法之一是生成電子表格或 CSV 文件。

在本文中，我們將探索如何在 Go 中創(chuàng)建電子表格，方法是構(gòu)建一個簡單的費用報告并使用 Excelize 庫將其導(dǎo)出為 CSV 格式。中找到本教程的完整代碼您可以在 GitHub 存儲庫。讓我們開始吧！

生成費用報告
創(chuàng)建工作表
添加數(shù)據(jù)和創(chuàng)建樣式
保存工作表
導(dǎo)出為 CSV

生成費用報告

費用報告是一份詳細的清單，盡可能詳細地顯示公司在一段時間內(nèi)的支出。我們將構(gòu)建一個類似于下圖中的報告：

創(chuàng)建工作表

要開始使用，請確保您已安裝 Go ≥v1.15 并創(chuàng)建一個新的項目文件夾。

在項目目錄中，創(chuàng)建一個 main.go文件并使用以下代碼初始化 Go 模塊：

$ mkdir <project-name>
$ cd <project-name>
$ touch main.go
$ go mod init github.com/<your-username>/<project-name>

The main.go file is the entry point of our Go application, and we use the generated go.mod file for dependency management. Next, install the Excelize library by running the command below:

$ go get github.com/xuri/excelize/v2

Excelize is a Go library with no dependencies that provides primitives for reading and writing to XLSX files and other supported spreadsheet file formats. In your main.go file, import Excelize, create a new file, create a new worksheet, and set the active sheet to the worksheet you just created:

package main
import "github.com/xuri/excelize/v2"
const (
   SheetName = "Expense Report"
)
func main() {
   var err error
   f := excelize.NewFile()
   index := f.NewSheet("Sheet1")
   f.SetActiveSheet(index)
   f.SetSheetName("Sheet1", SheetName)
}

添加數(shù)據(jù)和創(chuàng)建樣式

創(chuàng)建工作表后，我們可以開始構(gòu)建報告。首先，我們將設(shè)置一些尺寸以適應(yīng)我們想要的結(jié)構(gòu)，如下圖所示。

將以下代碼塊添加到您的 main功能：

//main.go
//...
   err = f.SetColWidth(SheetName, "A", "A", 6)
   err = f.SetColWidth(SheetName, "H", "H", 6)
   err = f.SetColWidth(SheetName, "B", "B", 12)
   err = f.SetColWidth(SheetName, "C", "C", 16)
   err = f.SetColWidth(SheetName, "D", "D", 13)
   err = f.SetColWidth(SheetName, "E", "E", 15)
   err = f.SetColWidth(SheetName, "F", "F", 22)
   err = f.SetColWidth(SheetName, "G", "G", 13)

我們只需要列 A至 G對于報告，所以我們使用 SetColWidth調(diào)整列的寬度以滿足我們的要求。你會注意到我們已經(jīng)定義了一個 error變量到頂部 main函數(shù)，我們只是將這些函數(shù)返回的任何錯誤分配給它。理想情況下，您應(yīng)該正確處理每個錯誤，因為它在 Go 中是慣用的，但保持代碼最少也是可以的。

Over 200k developers use LogRocket to create better digital experiences Learn more →

報告的第一部分包含靜態(tài)信息，因此我們將對其進行硬編碼。將以下代碼塊添加到您的 main 函數(shù)中：

//main.go
//...
   err = f.SetRowHeight(SheetName, 1, 12)
   err = f.MergeCell(SheetName, "A1", "H1")
?
   err = f.SetRowHeight(SheetName, 2, 25)
   err = f.MergeCell(SheetName, "B2", "D2")
?
   style, err := f.NewStyle(&excelize.Style{Font: &excelize.Font{Size: 20, Color: "6d64e8"}})
   err = f.SetCellStyle(SheetName, "B2", "D2", style)
   err = f.SetSheetRow(SheetName, "B2", &[]interface{}{"Gigashots Inc."})
   err = f.MergeCell(SheetName, "B3", "D3")
   err = f.SetSheetRow(SheetName, "B3", &[]interface{}{"3154 N Richardt Ave"})
?
   err = f.MergeCell(SheetName, "B4", "D4")
   err = f.SetSheetRow(SheetName, "B4", &[]interface{}{"Indianapolis, IN 46276"})
?
   style, err = f.NewStyle(&excelize.Style{Font: &excelize.Font{Color: "666666"}})
   err = f.MergeCell(SheetName, "B5", "D5")
   err = f.SetCellStyle(SheetName, "B5", "D5", style)
   err = f.SetSheetRow(SheetName, "B5", &[]interface{}{"(317) 854-0398"})
?
   style, err = f.NewStyle(&excelize.Style{Font: &excelize.Font{Size: 32, Color: "2B4492", Bold: true}})
   err = f.MergeCell(SheetName, "B7", "G7")
   err = f.SetCellStyle(SheetName, "B7", "G7", style)
   err = f.SetSheetRow(SheetName, "B7", &[]interface{}{"Expense Report"})
?
   style, err = f.NewStyle(&excelize.Style{Font: &excelize.Font{Size: 13, Color: "E25184", Bold: true}})
   err = f.MergeCell(SheetName, "B8", "C8")
   err = f.SetCellStyle(SheetName, "B8", "C8", style)
   err = f.SetSheetRow(SheetName, "B8", &[]interface{}{"09/04/00 - 09/05/00"})
?
   style, err = f.NewStyle(&excelize.Style{Font: &excelize.Font{Size: 13, Bold: true}})
   err = f.SetCellStyle(SheetName, "B10", "G10", style)
   err = f.SetSheetRow(SheetName, "B10", &[]interface{}{"Name", "", "Employee ID", "", "Department"})
   err = f.MergeCell(SheetName, "B10", "C10")
   err = f.MergeCell(SheetName, "D10", "E10")
   err = f.MergeCell(SheetName, "F10", "G10")
?
   style, err = f.NewStyle(&excelize.Style{Font: &excelize.Font{Color: "666666"}})
   err = f.SetCellStyle(SheetName, "B11", "G11", style)
   err = f.SetSheetRow(SheetName, "B11", &[]interface{}{"John Doe", "", "#1B800XR", "", "Brand & Marketing"})
   err = f.MergeCell(SheetName, "B11", "C11")
   err = f.MergeCell(SheetName, "D11", "E11")
   err = f.MergeCell(SheetName, "F11", "G11")
?
   style, err = f.NewStyle(&excelize.Style{Font: &excelize.Font{Size: 13, Bold: true}})
   err = f.SetCellStyle(SheetName, "B13", "G13", style)
   err = f.SetSheetRow(SheetName, "B13", &[]interface{}{"Manager", "", "Purpose"})
   err = f.MergeCell(SheetName, "B13", "C13")
   err = f.MergeCell(SheetName, "D13", "E13")
?
   style, err = f.NewStyle(&excelize.Style{Font: &excelize.Font{Color: "666666"}})
   err = f.SetCellStyle(SheetName, "B14", "G14", style)
   err = f.SetSheetRow(SheetName, "B14", &[]interface{}{"Jane Doe", "", "Brand Campaign"})
   err = f.MergeCell(SheetName, "B14", "C14")
   err = f.MergeCell(SheetName, "D14", "E14")

這段代碼中有很多內(nèi)容，所以讓我們分解一下。

如前所述，Excelize 提供了一組原始函數(shù)來操作電子表格。您需要的每個功能只需要在文件對象上調(diào)用一個方法，該方法接受一些參數(shù)。

在這種情況下，我們使用了五種主要方法：

SetRowHeight
MergeCell
NewStyle
SetCellStyle
SetSheetRow

SetRowHeight調(diào)整給定行的高度，以及 MergeCell將一行中的多個單元格合并為一個單元格。要編寫樣式，我們可以使用 excelize.Stylestruct，它提供了定義自定義樣式所需的屬性。這 NewStyle方法只是采用 Style對象并返回表示樣式的索引。

定義您的自定義樣式后，我們可以使用 SetCellStyle將樣式應(yīng)用于單個單元格或一系列單元格。我們用 SetSheetRow將數(shù)據(jù)添加到單行中的一個單元格或一系列單元格。它接受一個接口切片，它是任何原始數(shù)據(jù)類型的容器。切片是位置的，每個元素將從提供的軸開始放置在相應(yīng)的單元格中。因此，在合并多個單元格的某些情況下，我們使用了空字符串。

報告的第二部分是一個包含任意長度的動態(tài)數(shù)據(jù)的表格，這意味著我們不能像以前那樣只定義每一行的內(nèi)容。表中表示的數(shù)據(jù)遵循定義的結(jié)構(gòu)，因此我們可以循環(huán)傳入數(shù)據(jù)并動態(tài)創(chuàng)建每一行。

讓我們定義一些代表費用列表的任意數(shù)據(jù)。

在您的頂部 main.go文件，在 main函數(shù)，添加以下變量：

//main.go
//...
var (
   expenseData = [][]interface{}{
      {"2022-04-10", "Flight", "Trip to San Fransisco", "", "", "$3,462.00"},
      {"2022-04-10", "Hotel", "Trip to San Fransisco", "", "", "$1,280.00"},
      {"2022-04-12", "Swags", "App launch", "", "", "$862.00"},
      {"2022-03-15", "Marketing", "App launch", "", "", "$7,520.00"},
      {"2022-04-11", "Event hall", "App launch", "", "", "$2,080.00"},
   }
)
//...

現(xiàn)在，將以下代碼塊添加到您的 main 函數(shù)中：

//main.go
//...
   style, err = f.NewStyle(&excelize.Style{
      Font:      &excelize.Font{Size: 13, Bold: true, Color: "2B4492"},
      Alignment: &excelize.Alignment{Vertical: "center"},
   })
   err = f.SetCellStyle(SheetName, "B17", "G17", style)
   err = f.SetSheetRow(SheetName, "B17", &[]interface{}{"Date", "Category", "Description", "", "Notes", "Amount"})
   err = f.MergeCell(SheetName, "D17", "E17")
   err = f.SetRowHeight(SheetName, 17, 32)
?
   startRow := 18
   for i := startRow; i < (len(expenseData) + startRow); i++ {
      var fill string
      if i%2 == 0 {
         fill = "F3F3F3"
      } else {
         fill = "FFFFFF"
      }
      style, err = f.NewStyle(&excelize.Style{
         Fill:      excelize.Fill{Type: "pattern", Pattern: 1, Color: []string{fill}},
         Font:      &excelize.Font{Color: "666666"},
         Alignment: &excelize.Alignment{Vertical: "center"},
      })
      err = f.SetCellStyle(SheetName, fmt.Sprintf("B%d", i), fmt.Sprintf("G%d", i), style)
      err = f.SetSheetRow(SheetName, fmt.Sprintf("B%d", i), &expenseData[i-18])
      err = f.SetCellRichText(SheetName, fmt.Sprintf("C%d", i), []excelize.RichTextRun{
         {Text: expenseData\[i-18\][1].(string), Font: &excelize.Font{Bold: true}},
      })
?
      err = f.MergeCell(SheetName, fmt.Sprintf("D%d", i), fmt.Sprintf("E%d", i))
      err = f.SetRowHeight(SheetName, i, 18)
   }

我們?nèi)匀皇褂孟嗤姆椒▉斫M合樣式和添加數(shù)據(jù)。但是，我們正在循環(huán) expenseData列出并將每個項目添加到當前行。我們開始循環(huán) 18，這是電子表格中的當前行。為了使表格的行更加清晰易讀，我們通過使用 modulo手術(shù)。

導(dǎo)出為 CSV

到目前為止，我們已經(jīng)探索了使用 XLSX 文件，但是，還有其他格式適合呈現(xiàn)這種數(shù)據(jù)。 CSV 文件是一個文本文件，其中包含由逗號分隔的數(shù)據(jù)行，主要用于導(dǎo)入和導(dǎo)出數(shù)據(jù)。

考慮一種情況，我們希望將費用報告中的表存儲在某個自托管數(shù)據(jù)庫中。我們可以將這個表格提取為 CSV 格式，然后通過幾個步驟將其導(dǎo)入數(shù)據(jù)庫。

首先，在主函數(shù)之外創(chuàng)建一個名為 generateCSV并在下面添加代碼塊：

//main.go
//...
type Axis struct {
   row int
   col string
}
?
func generateCSV(f *excelize.File, start, end Axis) error {
   var data [][]string
?
   for i := start.row; i <= end.row; i++ {
      row := []string{}
      for j := []rune(start.col)[0]; j <= []rune(end.col)[0]; j++ {
         value, err := f.GetCellValue(SheetName, fmt.Sprintf("%s%d", string(j), i), excelize.Options{})
         if err != nil {
            return err
         }
         row = append(row, value)
      }
      data = append(data, row)
   }
?
   file, err := os.Create("expenses.csv")
   if err != nil {
      return err
   }
   defer f.Close()
?
   writer := csv.NewWriter(file)
   return writer.WriteAll(data)
}

這 generateCSV函數(shù)接受一個 excelize.File類型、起始軸和結(jié)束軸。軸只是構(gòu)成單元格的行和列的組合。我們循環(huán)遍歷每一行，對于每一行，我們循環(huán)遍歷開始軸和結(jié)束軸邊界內(nèi)的每一列。

然后我們使用 f.GetCellValue提取每個單元格的當前值。因為列表示為字母字符串，所以我們將它們轉(zhuǎn)換為符文以獲取底層的 unicode 十進制。最后，我們將提取的數(shù)據(jù)保存到 .csv文件使用標準庫中的 CSV 包。

我們可以在保存工作表并傳遞文件句柄后調(diào)用此函數(shù)。

在你的 main函數(shù)，添加以下代碼塊：

//main.go
///...
   err = f.SaveAs("expense-report.xlsx")
   err = generateCSV(f, Axis{17, "B"}, Axis{22, "G"})
?
   if err != nil {
      log.Fatal(err)
   }

我們提供了我們之前為工作表創(chuàng)建的文件和表示表格范圍的軸。

如果你運行 main.go文件，您應(yīng)該會看到生成的 XLSX 文件和 CSV 文件：