excelize 打开 .xlsx 失败主因是文件非标准 ooxml 格式（如 wps 兼容模式、改后缀的 .xls、.xlsm 等），需用 unzip 检查 zip 结构及必要 xml 文件，确认后另存为标准 .xlsx；sheet 不显示多因被 vba 隐藏或名称非法，可启用 skipunsupportedsheets 选项；写入性能差应改用 setsheetrow/col 批量操作；中文乱码、日期数字、公式不计算均属 excelize 不处理渲染/计算的正常行为。
用 excelize 打开已有 .xlsx 文件失败，报错 "unsupported file format"
常见原因是文件实际不是标准 Excel 2007+ 格式（比如是 WPS 保存的“兼容模式”、.xls 被改后缀、或带宏的 .xlsm），excelize 默认只认严格符合 OOXML 规范的 .xlsx。
- 先用
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）」，别选「Excel 97-2003」或「兼容模式」
-
excelize不支持 .xls、.csv、.xlsm（即使禁用宏），也暂不支持加密文件——遇到这些，得换tealeg/xlsx（仅读）或转格式预处理
f.GetSheetList() 返回空切片，但文件明明有 Sheet
不是 Sheet 被隐藏了，而是 excelize 加载时默认跳过「非常规状态」的 Sheet，比如被标记为 visible="veryHidden"（VBA 隐藏）或 state="hidden"，或者 Sheet 名含非法字符（如 [ ] * ? / \）导致解析失败。
- 用
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 名含空格或中文，
excelize能读，但写入新 Sheet 时建议用f.NewSheet("Sheet1")而非直接赋值，避免名称规范化冲突
写入大量数据时内存暴涨、速度慢
excelize 默认把整个工作簿缓存在内存里，每调一次 f.SetCellValue() 都会更新内部结构树，10 万行 × 10 列反复调用，性能会断崖下跌。
- 批量写用
f.SetSheetRow()或f.SetSheetCol()，传入[]interface{}切片比单个单元格快 5–10 倍 - 避免在循环里频繁调
f.SaveAs()，全部写完再存一次；如果中途要检查，用f.WriteTo(writer)写到bytes.Buffer测试 - 写入前调
f.SetActiveSheet(f.GetSheetIndex("Sheet1"))，否则每次SetCellValue都要查 Sheet 索引 - 超大数据（>50 万行）考虑分 Sheet 或导出为 CSV——Excel 本身对单 Sheet 行数有限制（1048576），
excelize不会帮你截断
中文乱码、日期变成数字、公式不计算
excelize 本身不处理字体渲染、日期序列化或公式引擎，它只按 Excel 规范写入原始值和类型标记。
- 中文正常显示的前提是：单元格样式里指定了支持中文的字体（如
"SimSun"或"Microsoft YaHei"），否则 Excel 可能 fallback 到不支持 Unicode 的字体——用f.SetCellStyle("Sheet1", "A1", "A1", styleID)显式设字体 - Go 的
time.Time直接传给SetCellValue会被转成 Excel 序列号（1900-01-01 起的天数），要显示为日期得同时设单元格类型为CellTypeDate并配日期格式（如"yyyy-mm-dd"） - 公式（如
=SUM(A1:A10)）写入后是字符串，Excel 打开时自动计算；但如果你用SetCellFormula写入，务必确保引用的单元格已存在值，否则显示#REF!；excelize不提供运行时计算能力
实际用下来，最常卡住的地方不是语法，而是 Excel 文件本身的“隐性状态”——比如一个被 VBA 隐藏的 Sheet、一个带自定义数字格式的单元格、甚至 Windows 和 macOS 下换行符差异导致的样式解析失败。动手前先用 unzip 看一眼 xl/ 目录结构，比查文档快得多。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
