多级表头需先逐单元格写值再统一合并，不可用SetSheetRow替代；关键步骤为：1.用SetCellValue精确写入各级标题；2.按行列严格对齐调用MergeCell（如"A1:C1"）；3.避免在已合并区域重复写值。
多级表头在 Excel 中怎么写入？
excelize/v2 不支持直接“合并单元格 + 写入内容”一步到位的多级表头，必须手动控制行列坐标、调用 SetCellValue 和 MergeCell 配合完成。常见错误是只写值不合并，或合并范围错位导致 Excel 打开报错。
关键点：先写所有单元格的值，再统一合并；合并范围必须严格对齐行列（比如 A1:B1 合并后，A2:B2 就不能再跨列合并同一逻辑层级）。
-
MergeCell的参数是起始和结束坐标字符串，如"A1:B1"，不是行列索引数字 - 若表头有 2 行，第 1 行是大类（跨 3 列），第 2 行是子项（各占 1 列），需先写 A1、B1、C1（值为空或占位），再写 A2、B2、C2（子标题），最后
MergeCell("A1:C1") - 避免在已合并区域里重复调用
SetCellValue—— 后续写入会失败但不报错，Excel 打开时可能显示空白
为什么用 SetSheetRow 不能替代逐单元格写入？
SetSheetRow 是批量写入单行数据的快捷方法，但它会把整行按 slice 顺序硬塞进连续列（从指定列开始），无法跳过某些列、也无法为不同列设置不同样式或合并。多级表头往往需要非连续布局（比如第 1 行只在 A1、D1、G1 有内容），这时必须用 SetCellValue 精确控制每个单元格。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 先用
SetSheetRow写普通数据行（性能更好），但表头一律手写坐标 - 如果表头结构固定，可封装一个
writeMultiLevelHeader函数，传入 sheet 名、起始行、列偏移和层级定义 slice - 注意：
SetSheetRow对空值（nil 或 ""）会写入空字符串，而 Excel 单元格留空和写入 "" 在部分公式/筛选行为上表现不同
导出接口里如何避免中文乱码和文件名截断？
Gin 响应头设置顺序和编码方式直接影响客户端能否正确识别文件名和内容。最常踩的坑是：先写数据再设 header，或用了 filename= 而不是 filename*=UTF-8''。
正确做法：
- 必须在任何
c.Writer.Write或f.Write(c.Writer)之前调用c.Header - 文件名用
url.QueryEscape("销售统计_2026年.xlsx")，然后拼到Content-Disposition的filename*=UTF-8''后面 - Excel 不需要 BOM；CSV 若要兼容旧版 Excel，可在响应体开头写入
[]byte{0xEF, 0xBB, 0xBF}，但注意这必须是响应体第一字节 -
Content-Type必须匹配格式：application/vnd.openxmlformats-officedocument.spreadsheetml.sheet（xlsx），不是application/octet-stream（后者会导致 Safari 下载后自动解压）
大数据量下多级表头 + 流式导出是否可行？
可以，但仅限 CSV；Excel 的多级表头天然与流式冲突——因为 MergeCell 必须在写完所有相关单元格后才能调用，而流式要求边查边写、不缓存整表。所以实际中只有两种选择：
- 小数据量（excelize.File，写完再
f.Write(c.Writer) - 大数据量：放弃 Excel 多级表头，改用 CSV（用制表符或空行分隔逻辑层级），或降级为单级表头 + 注释行说明
- 折中方案：生成带多级表头的 Excel 文件存本地磁盘 / 对象存储，返回下载链接，用异步任务 + 状态轮询实现
真正容易被忽略的是：即使你用 StreamWriter，只要涉及 MergeCell，就无法真正流式——它内部仍需维护 XML 结构上下文，必须等全部单元格写完才能 flush 合并指令。
