Golang 模塊引入及表格讀寫業務快速實現示例

Posted on by

介紹

在很多管理系統下都有不少讓後端進行表格進行操作的業務需求，本期就帶大傢瞭解一下Golang中如何使用模塊引入的，以及講解怎麼快速的使用excelize庫，對表格進行讀寫創建的。

正文

配置模塊引入環境

我們在期望在vscode終端中也可以使用模塊引入，它是 Go 1.11後新版模塊管理方式。

go env -w GO111MODULE=auto

其 GO111MODULE 可以傳遞：

  • auto：在其外層且根目錄裡有 go.mod 文件時，則開啟模塊支持，否者無模塊支持。
  • on：開啟模塊支持。
  • off：無模塊支持。

然後，初始化這個項目，就會生成一個 go.mod 文件。

go mod init excel-demo

 go.mod 是Go 1.11版本引入的官方的包管理工具（之前為 gopath 來管理），它可以理解為前端開發中的 npm 的作用，主要是為瞭解決沒有記錄依賴包具體版本查閱困難的問題，也極大程度上方便瞭依賴包的管理。

引入excelize庫

excelize 是一個用於讀寫 Microsoft Excel™2007 及更高版本生成的電子表格文檔（XLAM / XLSM / XLSX / XLTM / XLTX）的 Go 語言庫，而且更新維護頻繁且非常好用。

引入excelize

go get github.com/xuri/excelize/v2

這裡因為站點是國外的所以經常會因無法訪問而超時。此時，不要慌，我們換一個國內的代理就好瞭。

go env -w GOPROXY=https://goproxy.cn

創建表格

package main
import (
    "fmt"
    "github.com/xuri/excelize/v2"
)
func createExcel(){
    // 創建表格文件
	f := excelize.NewFile()
    // 在Sheet1設置A1項的值
	f.SetCellValue("Sheet1", "A1", "這是Sheet1的A1項")
    // 創建新的Sheet，命名為Sheet2
	selectIndex := f.NewSheet("Sheet2")
    // 在Sheet2設置B2項的值
	f.SetCellValue("Sheet2", "B2", "這是Sheet2的B2項")
    // 切換到Sheet2
    f.SetActiveSheet(selectIndex)
    // 保存文件
    if err := f.SaveAs("test.xlsx"); err != nil {
        fmt.Println(err)
    }
}
func main() {
    // 執行創建表格
	createExcel()
}

按照以上是創建文件並在列上隨便寫入一些數據然後保存下來，非常的簡單，現在我們來執行一下，就會發現當前目錄會多出一個text.xlsx文件，沒錯，這就是我們剛才生成出來的表格文件，打開它就可以看到我們剛才寫入的一些內容瞭。

讀取表格

func openExcel(){
	// 讀取test.xlsx表格文件
	f, err := excelize.OpenFile("test.xlsx")
    if err != nil {
        fmt.Println(err)
        return
    }
    // 獲取Sheet2的B2項的值
    cell, err := f.GetCellValue("Sheet2", "B2")
    if err != nil {
        fmt.Println(err)
        return
    }
	fmt.Println(cell)
	fmt.Println("---------------")
	// 獲取Sheet1所有的項
    rows, err := f.GetRows("Sheet1")
    if err != nil {
        fmt.Println(err)
        return
	}
	// 遍歷Sheet1所有的項並打印出來
    for _, row := range rows {
        for _, colCell := range row {
            fmt.Print(colCell, "\t")
        }
        fmt.Println()
    }
}

上面做的操作是把我們剛才保存好的表格文件的內容讀取出來，這裡分瞭兩種形式，一種是用 GetCellValue 方法讀取某個sheet的某一項，另一種是用 GetRows 對獲取整個sheet的項，然後for循環遍歷出來。

寫入表格

剛剛在創建的時候其實已經使用 SetCellValue 方法對表格的寫入操作，但這還遠遠不夠，因為還有很多東西我們可以寫入進去，比如說圖表和圖片甚至是其他表格文件。圖表這裡先簡單說明一下，它用瞭 AddChart 方法也是對某一項進行操作，插入相關數據進去，形式如下（詳見文檔）：

if err := f.AddChart("Sheet1", "E1", `{
        "type": "col3DClustered",
        "series": [
        {
            "name": "Sheet1!$A$2",
            "categories": "Sheet1!$B$1:$D$1",
            "values": "Sheet1!$B$2:$D$2"
        }]
        }`); err != nil {
    fmt.Println(err)
    return
}

接下來，我們主要講一下圖片是如何寫入進表格的，首先，我們先準備一張圖片，就放在assets目錄吧，然後在到 import 中導入jpeg和png，目的是明確後面要解析的圖片（目前可以解析出jpeg,jpg,png格式的圖片瞭），如果不寫或者格式不對則會出現 image: unknown format 的提示。

package main
import (
	"fmt"
	_ "image/jpeg"
    _ "image/png"
    "github.com/xuri/excelize/v2"
)

然後我們還是要讀取一下剛剛生成出來的test.xlsx表格文件，再把圖片寫入進去。

func setPic(){
	f, err := excelize.OpenFile("test.xlsx")
    if err != nil {
        fmt.Println(err)
        return
	}
	// 導入並設置圖片
    if err := f.AddPicture("Sheet2", "C3", "assets/anya.png",
		`{
			"x_offset": 10,
        	"y_offset": 10,
			"x_scale": 0.8, 
			"y_scale": 0.8
		}`); err != nil {
        fmt.Println(err)
	}
	// 保存剛才的操作
	if err = f.Save(); err != nil {
        fmt.Println(err)
    }
}

而且圖片還可以這是位置，大小等參數，但這裡一定要記住不管添加瞭什麼最後一定要保存一下，不然就是一場空。最後麼，一個小阿尼亞就寫入到瞭表格中啦~

結語

本篇主要是帶大傢簡單瞭解怎麼使用excelize庫對表格進行操作，其實都還是皮毛，它的功能比你想的還要強大，詳細的可以看 官方文檔 ，算是一個非常實用的工具庫瞭，更多關於Go模塊引入表格讀寫的資料請關註WalkonNet其它相關文章！

推薦閱讀：