golang怎么用excel-Golang-PHP中文网

excelize仅支持严格符合ooxml规范的.xlsx文件，需验证文件头和结构；读取时注意隐藏sheet、合并单元格、空行处理；写入应批量操作并显式设置样式与类型；并发写必须加锁。

直接用 excelize，别碰 tealeg/xlsx（已停更）、go-excel（非主流）或试图自己解析 zip——它能覆盖 95% 的真实业务场景，但踩坑点非常集中，不提前知道会卡一整天。

不是代码写错了，是文件本身不标准。Excelize 只认严格符合 OOXML 规范的 .xlsx，WPS「兼容模式」、手动改后缀的 .xls、带宏的 .xlsm 全部拒收。

先确认文件头：file your.xlsx（Linux/macOS）或 Get-Item your.xlsx | % { $_.Length }（PowerShell），真正有效的 .xlsx 是 ZIP 包，开头必须是 PK\x03\x04
再查结构：unzip -l your.xlsx，必须同时存在 [Content_Types].xml 和 xl/workbook.xml，缺一个就加载失败
修复方式：用 Excel for Mac、LibreOffice 或新版 Windows Excel 打开后，另存为「Excel 工作簿（*.xlsx）」，**绝对不要选「Excel 97-2003」或勾选「兼容模式」**
加密文件、CSV、XLS、XLTM 全都不支持——没商量，得预处理转格式或换库

不是文件没 Sheet，是 excelize 默认跳过「非标准可见状态」的 Sheet：比如被 VBA 设为 veryHidden，或者 Sheet 名含 [ ] * ? / \ 这类非法字符，XML 解析直接丢弃。

用 unzip -p your.xlsx xl/workbook.xml | grep -E "(sheet|name=)" 直接看原始 XML，确认 <sheet></sheet> 标签完整、name 属性合法、state 值是 visible
强制加载所有 Sheet：f, err := excelize.OpenFile("x.xlsx", excelize.Options{SkipUnsupportedSheets: false})，但注意这可能 panic（比如 Sheet 结构损坏）
新建 Sheet 时别手写名称字符串，用 f.NewSheet("数据表")，避免自动规范化导致名称意外变更

excelize 不做逻辑层抽象，它按物理行列索引读取。A1:B1 合并后，f.GetCellValue("Sheet1", "B1") 就是空——因为 B1 单元格在底层确实没存值。

Go语言（Golang）1.26.0

Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。

下载

读前先调 f.GetMergeCells("Sheet1")，拿到所有合并范围（如 "A1:B1"），再手动把 A1 的值映射到 B1
别用 f.GetSheetMap() + 硬循环最大行数，Excel 底部常有上万空行；改用 f.GetSheetRow("Sheet1", row) + 判空，只读实际有内容的行
f.GetSheetRow() 比反复调 f.GetCellValue() 快 3–5 倍，尤其文件 >1MB 时差异明显

这些都不是 bug，是 excelize 的设计选择：它默认缓存整份工作簿，且不做类型自动推导和渲染。

批量写用 f.SetSheetRow() 或 f.SetSheetCol()，传 []interface{}，比单个 f.SetCellValue() 快 5–10 倍
中文显示异常？先 utf8.ValidString(s) 检查输入是否合法 UTF-8；再显式设样式：f.NewStyle(&excelize.Style{Font: &excelize.Font{Family: "微软雅黑"}})，然后 f.SetCellStyle()
数字变 1.2345E7？说明 Excel 存的是浮点型，用 f.GetCellFloat64() 拿原始值，再 fmt.Sprintf("%.0f", v) 格式化
公式不计算、日期显示为数字？需手动启用：f.Calculation.On = true，再调 f.Calculate()