excelize 读取空行或合并单元格错位，因其按物理行列索引读取，不自动处理隐藏行和合并单元格逻辑；需调用 GetMergeCells 手动映射，用 GetSheetRow + 判空替代硬循环最大行数。
为什么 excelize 读取空行或合并单元格时数据错位？
因为 excelize 默认按物理行/列索引读取，不自动跳过隐藏行、忽略合并单元格的“占位”逻辑。比如 A1:B1 合并后，f.GetCellValue("Sheet1", "B1") 仍返回空字符串，但实际业务中你可能期望它和 A1 值一致。
- 读合并单元格前先调用
f.GetMergeCells()获取所有合并范围，再手动映射到目标单元格 - 遍历行时别直接用
f.GetSheetMap()后硬循环最大行数，改用f.GetSheetRow("Sheet1", row)+ 判空组合，避免读到 Excel 底部大量空白行 - 如果源文件由 Excel 手动保存（非程序生成），注意检查是否启用了“自动换行”或“缩放适应”，这类格式不影响
GetCellValue，但会导致GetSheetRow返回切片长度异常
f.GetSheetRow 和 f.GetCellValue 选哪个？
看你要不要保留原始行列结构。f.GetSheetRow 按行拉取一整行的值（[]string），适合逐行解析、校验、转 struct；f.GetCellValue 更轻量，适合只查几个关键字段（如读取标题行第3列的字段名）。
- 用
f.GetSheetRow时注意：空单元格返回空字符串""，不是nil，判空得用strings.TrimSpace防止中间有空格 - 用
f.GetCellValue时注意：参数是 sheet 名 + 单元格地址（如"C5"），不是行列数字，别写成f.GetCellValue("Sheet1", 3, 5)—— 这会编译报错 - 性能上，批量读一行比反复调
GetCellValue20 次快 3–5 倍，尤其文件超 1MB 后差异明显
中文乱码或数字被转成科学计数法怎么办？
这是 Excel 自身存储格式导致的，不是 excelize 的 bug。xlsx 里文本型数字、带格式的中文都可能被误判类型。
- 读取前加
f.SetCellValue("Sheet1", "A1", "2024年")这类操作不会触发问题，但读的时候得主动干预类型：用f.GetCellType("Sheet1", "A1")判断是CellTypeString还是CellTypeNumeric - 遇到数字变
1.2345E7，说明 Excel 存的是浮点数格式，需用f.GetCellFloat64读出原始值，再按需格式化：fmt.Sprintf("%.0f", v) - 中文显示为方块或问号？检查文件是否真为 UTF-8 编码的 xlsx —— 有些老旧 Windows Excel 保存时默认用 GBK 写入元数据，
excelize无法修复，只能让上游重存为「Excel 工作簿（*.xlsx）」而非「Excel 97-2003 工作簿（*.xls）」
如何安全跳过表头、处理多 sheet 场景？
别硬编码 "Sheet1"，也别假设第一行一定是表头。真实业务里常有封面页、说明页、多个数据 tab。
立即学习“go语言免费学习笔记（深入）”；
- 用
f.GetSheetList()拿到所有 sheet 名，再用f.GetSheetName(0)确认索引 0 是否真对应你要的数据页 - 表头识别建议：读前 3 行，用
strings.Contains扫描关键词（如"用户ID"、"手机号"），定位到哪行开始是有效数据，而不是固定从第 2 行开始 - 如果某 sheet 为空（
f.GetSheetMap()["Sheet2"] == nil），f.GetSheetRow("Sheet2", 1)会 panic，务必先f.GetSheetList()校验存在性
