用excelize/v2写复杂表头必须手动控制行列坐标和合并范围，唯一可靠方式是先mergecell再setcellvalue，且样式设在起始单元格；文件名需url.queryescape编码并正确设置content-disposition和content-type；大数据量时应改用writetobuffer+分块写入并及时flush。
直接用 excelize/v2 写复杂表头（比如合并单元格、多级标题、跨列居中）是可行的，但必须手动控制行列坐标和合并范围，不能靠“自动适配”——这是最常被低估的门槛。
为什么 SetCellValue + MergeCell 是唯一可靠方式
很多人想用结构体反射或二维切片“一键填表”，但复杂表头本质是布局问题，不是数据映射问题。比如“部门汇总”横跨 A–D 列、“人数”和“占比”在第二行分列、“2024年度”作为顶层标题单独占一行并居中——这些都需要精确指定起止单元格。
-
excelize.MergeCell("Sheet1", "A1", "D1")合并 A1–D1，再用SetCellValue写入内容 - 必须先调用
MergeCell，再调用SetCellValue，顺序反了会失效 - 合并后设置样式（如居中）要作用在左上角单元格（即起始单元格），例如
SetCellStyle("Sheet1", "A1", "A1", styleID) - 如果表头有 3 行，数据从第 4 行开始写，那所有
SetCellValue的行号都要从 4 起算，别漏掉偏移
中文乱码与文件名不显示的硬性配置
导出 Excel 时中文正常，但下载后文件名变成 %E6%B5%8B%E8%AF%95.xlsx 或打开报“文件损坏”，大概率是响应头没设对。
- 文件名必须用
url.QueryEscape("报表-2024Q3.xlsx")编码，再拼进Content-Disposition，格式为attachment; filename*=UTF-8''{encoded} -
Content-Type必须是application/vnd.openxmlformats-officedocument.spreadsheetml.sheet，不是application/octet-stream（后者会导致某些浏览器无法识别） - 不要写 BOM 头（
0xEF, 0xBB, 0xBF）——那是 CSV 用的，Excel 不需要，加了反而可能破坏 ZIP 结构
性能隐患：大表头 + 大数据量时别用 WriteToResponse
当表头有 5 行、列数超 20、总行数过万时，f.Write(c.Writer) 可能阻塞 HTTP 连接，尤其在高并发下容易触发超时或内存暴涨。
- 改用
f.WriteToBuffer()先生成*bytes.Buffer，再用io.Copy分块写入c.Writer - 对超大数据，建议加
c.Writer.Flush()在每写入 1000 行后主动刷一次缓冲区 - 务必 defer
f.Close()，否则内存泄漏；若用了WriteToBuffer()，就不用 defer Close —— 它只在NewFile()后有效，Buffer 是只读副本
复杂表头真正的难点不在“怎么画”，而在“怎么让坐标计算不出错”。建议把表头结构先手动画个网格草图，标好每一块的起止行列，再转成代码。临时改一列，很可能要重算后面全部合并区域——这点最容易被忽略。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
