Go语言Excel操作教程：excelize读写详解

Go语言中使用excelize操作Excel虽是当前最稳定的选择，但新手极易在文件落盘、数字格式解析、单元格类型读取和并发写入等关键环节踩坑：Save()不保证磁盘写入需改用SaveAs或WriteTo；SetCellValue写数字须配合NumFmt样式或转字符串防误判为日期/科学计数；读取应优先调用GetCellFloat/Int而非GetCellValue以获取原始值，并注意公式、合并单元格与编码问题；而并发写必须避免共用File实例，否则触发致命panic——掌握这些“反直觉”细节，才能真正驾驭excelize高效可靠地处理Excel。

用 excelize 读写 Excel 是目前 Go 生态最稳的选择，但直接上手容易在文件打开、样式写入和单元格类型上栽跟头。

为什么不能用 f.Save() 后立刻用系统打开文件

常见错误是调用 f.Save() 后双击生成的 .xlsx 文件，提示“文件已损坏”或“无法打开”。这不是代码问题，而是 Save() 默认只写入内存缓冲，没真正 flush 到磁盘——尤其在 Windows 上更明显。

• 正确做法：改用 f.WriteTo() 配合 os.Create() 显式写文件
• 或者用 f.SaveAs("out.xlsx")，它内部会处理 flush，比 Save() 更可靠
• 如果用 Save()，必须确保文件句柄已关闭，且程序没提前退出（比如 defer f.Close() 后没等 Save 完就 return）

SetCellValue() 写数字却显示成日期或科学计数

Excel 会根据单元格格式自动解释数值。Go 传的是 float64 或 int，但 Excel 可能把它当时间戳（如 44197 被识别为 2021-01-01）或强制转成 1.23E+10。

• 先用 f.SetColWidth("Sheet1", "A", "A", 20) 扩宽列，避免显示截断
• 再用 f.SetCellStyle("Sheet1", "A1", "A1", styleID) 绑定一个显式数字格式样式
• 样式里关键字段是 NumFmt: 1（常规）、NumFmt: 2（千位分隔）、NumFmt: 4（两位小数），别用 0（自定义格式可能为空）
• 如果只是临时避免解析，可把数字转成字符串传： f.SetCellValue("Sheet1", "A1", strconv.FormatFloat(x, 'f', 2, 64))

读取时 GetCellValue() 返回空或乱码

不是所有单元格都存原始值。GetCellValue() 返回的是 Excel 渲染后的字符串结果，依赖公式计算、合并单元格、共享字符串表（Shared String Table）等机制。

• 纯数值单元格，优先用 f.GetCellFloat("Sheet1", "A1") 或 f.GetCellInt("Sheet1", "A1") 直接取原始类型
• 含公式的单元格，需确认是否启用计算：f.CalcCellValue("Sheet1", "A1")，否则返回空
• 中文乱码？检查文件是否是 UTF-8 BOM 编码保存的 .xlsx —— excelize 不处理编码转换，它读的是 Excel 内部 Unicode 字符串，乱码大概率是源文件本身异常或被其他工具二次损坏
• 合并单元格读取：只有左上角单元格有值，其余位置 GetCellValue() 返回空，得先用 f.GetMergeCells() 判断范围

并发写多个 Sheet 导致 panic: "concurrent map read and map write"

*excelize.File 实例不是 goroutine 安全的。多个 goroutine 同时调用 SetCellValue()、SetRow() 等方法会触发 map 并发读写 panic。

• 不要在 goroutine 里共用同一个 f 实例
• 如果要并行处理数据，先用 channel 收集好所有待写入的 (sheet, row, col, value) 元组，最后单 goroutine 顺序写入
• 或者为每个 Sheet 创建独立 *excelize.File（不推荐，内存开销大），再用 f.CopySheet() 合并
• 注意：f.NewSheet() 和 f.DeleteSheet() 也非并发安全，必须串行调用

最麻烦的其实是隐藏格式——比如某列看着是数字，实际是自定义格式加了前缀文本，这时 GetCellFloat() 会失败返回 0，但 GetCellValue() 又带上了不该有的字符。这种得靠 f.GetCellType() + f.GetCellStyle() 组合判断，没法偷懒。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Go语言Excel操作教程：excelize读写详解》文章吧，也可关注golang学习网公众号了解相关技术文章。