Go-Excelize API源码阅读（一）——NewFile()

Go-Excelize API源码阅读（一）——NewFile()

开源摘星计划（WeOpen Star） 是由腾源会 2022 年推出的全新项目，旨在为开源人提供成长激励，为开源项目提供成长支持，助力开发者更好地了解开源，更快地跨越鸿沟，参与到开源的具体贡献与实践中。

不管你是开源萌新，还是希望更深度参与开源贡献的老兵，跟随“开源摘星计划”开启你的开源之旅，从一篇学习笔记、到一段代码的提交，不断挖掘自己的潜能，最终成长为开源社区的“闪亮之星”。

我们将同你一起，探索更多的可能性！

项目地址： WeOpen-Star：https://github.com/weopenprojects/WeOpen-Star

一、Go-Excelize简介

Excelize 是 Go 语言编写的用于操作 Office Excel 文档基础库，基于 ECMA-376，ISO/IEC 29500 国际标准。可以使用它来读取、写入由 Microsoft Excel™ 2007 及以上版本创建的电子表格文档。支持 XLAM / XLSM / XLSX / XLTM / XLTX 等多种文档格式，高度兼容带有样式、图片(表)、透视表、切片器等复杂组件的文档，并提供流式读写 API，用于处理包含大规模数据的工作簿。可应用于各类报表平台、云计算、边缘计算等系统。使用本类库要求使用的 Go 语言为 1.15 或更高版本。

二、NewFile()

该API的功能是利用默认的模板创建新的 Excel 工作薄，新创建的工作簿中会默认包含一个名为 Sheet1 的工作表。

func NewFile() *File {
	f := newFile()
	f.Pkg.Store("_rels/.rels", []byte(xml.Header+templateRels))
	f.Pkg.Store(defaultXMLPathDocPropsApp, []byte(xml.Header+templateDocpropsApp))
	f.Pkg.Store(defaultXMLPathDocPropsCore, []byte(xml.Header+templateDocpropsCore))
	f.Pkg.Store("xl/_rels/workbook.xml.rels", []byte(xml.Header+templateWorkbookRels))
	f.Pkg.Store("xl/theme/theme1.xml", []byte(xml.Header+templateTheme))
	f.Pkg.Store("xl/worksheets/sheet1.xml", []byte(xml.Header+templateSheet))
	f.Pkg.Store(defaultXMLPathStyles, []byte(xml.Header+templateStyles))
	f.Pkg.Store(defaultXMLPathWorkbook, []byte(xml.Header+templateWorkbook))
	f.Pkg.Store(defaultXMLPathContentTypes, []byte(xml.Header+templateContentTypes))
	f.SheetCount = 1
	f.CalcChain = f.calcChainReader()
	f.Comments = make(map[string]*xlsxComments)
	f.ContentTypes = f.contentTypesReader()
	f.Drawings = sync.Map{}
	f.Styles = f.stylesReader()
	f.DecodeVMLDrawing = make(map[string]*decodeVmlDrawing)
	f.VMLDrawing = make(map[string]*vmlDrawing)
	f.WorkBook = f.workbookReader()
	f.Relationships = sync.Map{}
	f.Relationships.Store("xl/_rels/workbook.xml.rels", f.relsReader("xl/_rels/workbook.xml.rels"))
	f.sheetMap["Sheet1"] = "xl/worksheets/sheet1.xml"
	ws, _ := f.workSheetReader("Sheet1")
	f.Sheet.Store("xl/worksheets/sheet1.xml", ws)
	f.Theme = f.themeReader()
	return f
}

f.Pkg是file结构体的一个成员,定义要填充的电子表格文件结构。

type File struct {
	...省略其他...
	Pkg              sync.Map
}

func (m *Map) Store(key, value any)是将值存入Map之中。

接下来，SheetCount是表格的数量。默认是一个Sheet1，所以初始数量是1.

CalcChain是有calcChainReader()计算的，该函数解析defaultXMLPathCalcChain配置中的文件生成一个xlsxCalcChain类型的数据，程序中读取的文件地址是xl/calcChain.xml。xlsxCalcChain直接映射calcChain元素。这个元素代表了计算链的根。

Comments新建一个map[string]*xlsxComments。

ContentTypes由contentTypesReader创建，contentTypesReader提供了一个函数来获取反序列化后的[Content_Types].xml文件结构的指针。

f.Relationships和f.Drawings = sync.Map{}是创建一个并发状况下的Map。

同样的，Styles由f.stylesReader()创建，提供了一个函数来获取反序列化后的xl/styles.xml文件结构的指针。f.WorkBook也差不多。

VMLDrawing 、DecodeVMLDrawing都是创建map。

接下来是sheet1的相关创建操作。

三、结语

这里是老岳，这是Go语言相关源码的解读第一篇，我会不断努力，给大家带来更多类似的文章，恳请大家不吝赐教。