Go-Excelize API源码阅读（四十）——SetCellRichText

开源摘星计划（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 或更高版本。

二、SetCellRichText

func (f *File) SetCellRichText(sheet, cell string, runs []RichTextRun) error

根据给定的工作表、单元格坐标和富文本格式为指定单元格设置富文本。

例如，在名为 Sheet1 的工作表 A1 单元格设置富文本格式：

废话少说，直接看源码：

func (f *File) SetCellRichText(sheet, cell string, runs []RichTextRun) error {
	ws, err := f.workSheetReader(sheet)
	if err != nil {
		return err
	}
	c, col, row, err := f.prepareCell(ws, cell)
	if err != nil {
		return err
	}
	if err := f.sharedStringsLoader(); err != nil {
		return err
	}
	c.S = f.prepareCellStyle(ws, col, row, c.S)
	si := xlsxSI{}
	sst, err := f.sharedStringsReader()
	if err != nil {
		return err
	}
	if si.R, err = setRichText(runs); err != nil {
		return err
	}
	for idx, strItem := range sst.SI {
		if reflect.DeepEqual(strItem, si) {
			c.T, c.V = "s", strconv.Itoa(idx)
			return err
		}
	}
	sst.SI = append(sst.SI, si)
	sst.Count++
	sst.UniqueCount++
	c.T, c.V = "s", strconv.Itoa(len(sst.SI)-1)
	return err
}

先打开工作表阅读器，根据工作表名获取工作表对象。

prepareCell的源码如下：

mergeCellsParser能够在单元格被合并的情况下其获取单元格cell对象，然后获取其行序号row和列序号col，然后做一下工作表XML的准备工作，然后得到了cell对象，行号、列号和err对象返回。

sharedStringsLoader从系统临时文件中加载共享字符串表到内存中，并重置共享字符串表。

下面来看最后一部分：

prepareCellStyle主要是看样式等比如行、列是否满足要求等等准备工作。

新建了xlsxSI结构体，其为是共享字符串表中单个字符串的表示。

然后调用setRichText设置单元格的富文本。

然后遍历sst.SI，将得到的strItem与si继续深度比较，如果深度相等，就执行c.T, c.V = "s", strconv.Itoa(idx)，然后将si放入sst.SI切片之中，sst.Count和sst.UniqueCount加一。

结语

这是Excelize API阅读的第四十篇，鉴于本人技术水平有限，如有错误，烦请指出斧正！感谢！