excelize是Go生态处理.xlsx最可靠的选择，但需注意文件必须符合OOXML规范、强制启用隐藏Sheet需设SkipUnsupportedSheets为false、读中文/日期/公式须判类型并显式计算、写大数据应批量操作或流式输出。
excelize 是当前 go 生态中读写 .xlsx 文件最可靠的选择，它不依赖外部程序、支持样式/公式/合并单元格，且能流式处理大文件。但直接调用文档 api 容易踩坑——比如打不开文件、读不到 sheet、中文变方块、性能断崖下跌。下面说清楚几个关键实操点。
OpenFile 报 "unsupported file format" 怎么办
不是库坏了，是文件本身不标准。Excelize 只认严格符合 OOXML 规范的 .xlsx，WPS「兼容模式」、手动改后缀的 .xls、带宏的 .xlsm 都会被拒。
- 先用
file your.xlsx（Linux/macOS）或 PowerShell 的Get-Item your.xlsx | % { $_.Length }看文件头：真正.xlsx是 ZIP 包，开头必须是PK\x03\x04 - 再用
unzip -l your.xlsx检查内部结构：必须含[Content_Types].xml和xl/workbook.xml，缺一不可 - 确认是 WPS 或旧 Excel 导出的，就用 LibreOffice 或 Excel for Mac 重新「另存为 → Excel 工作簿(*.xlsx)」，别选「97-2003」或「兼容模式」
-
excelize明确不支持.xls、.csv、.xlsm和加密文件；这类文件得先转格式，或换tealeg/xlsx（仅读）
GetSheetList() 返回空切片，但文件明明有 Sheet
不是没加载，是默认跳过了「非常规状态」的 Sheet：比如被 VBA 设为 visible="veryHidden"，或 <sheet state="hidden"></sheet>，又或者 Sheet 名含非法字符（[ ] * ? / \）导致 XML 解析失败。
- 用
unzip -p your.xlsx xl/workbook.xml | grep -E "(sheet|name=)"直接看原始 XML，确认<sheet></sheet>标签完整、name属性合法、state是visible - 加载时加选项强制启用：
f, err := excelize.OpenFile("x.xlsx", excelize.Options{SkipUnsupportedSheets: false})，但注意这可能 panic（如 Sheet 结构已损坏） - Sheet 名含中文或空格可以读，但新建 Sheet 时建议用
f.NewSheet("数据表")，别直接赋值，避免名称规范化冲突
读取中文乱码、数字变科学计数法、日期为空
这不是 excelize 的 bug，是 Excel 自身存储机制决定的：文本型数字、带格式中文、日期浮点数都可能被误判类型。GetCellValue 返回的是“渲染后”的值，容易失真。
- 读前先查类型：
cellType, _ := f.GetCellType("Sheet1", "A1")，区分CellTypeString、CellTypeNumeric、CellTypeDate、CellTypeFormula - 数字变
1.2345E7？说明存的是浮点数，用f.GetCellFloat64("Sheet1", "A1")拿原始值，再fmt.Sprintf("%.0f", v)格式化 - 日期显示为空或错乱？用
f.GetCellFloat64拿到 Excel 底层浮点数，再传给time.DateFromExcel(v, time.UTC) - 公式结果为空？需显式开启计算：
f.Calculation.On = true，然后调f.Calculate()，否则只读静态值
写入 10 万行数据慢、内存暴涨
默认每调一次 f.SetCellValue() 都会更新整个内存中的结构树，10 万 × 10 列就是百万次操作，性能直接崩。根本原因不是库慢，是调用方式不对。
立即学习“go语言免费学习笔记（深入）”；
- 批量写用
f.SetSheetRow("Sheet1", 2, rowData)或f.SetSheetCol("Sheet1", "A", colData)，传[]interface{}切片，比单点写快 5–10 倍 - 导出超大报表时，别等全写完再
f.WriteTo，而是边写边流式输出：f.WriteTo(w io.Writer)直接写入http.ResponseWriter或文件句柄，避免全量驻留内存 - 如果必须单点写，至少把
f.SetCellStyle和f.SetColWidth提前批量设好，避免每次写都触发样式重算
真正难的不是“怎么写”，而是判断文件是否合规、类型是否准确、写法是否匹配数据规模。很多问题在 unzip 看一眼 XML、加一行类型判断、换一个写入函数就能绕开。
