用Golang构建Excel导出服务应选用excelize/v2库,通过新建工作簿、写入表头与数据、设置格式、删除默认Sheet,最后WriteToResponse直接响应;需注意大文件分批处理、中文编码、日期转换、数值类型及安全校验。

用 Golang 构建导出 Excel 服务,核心是选对库、组织好数据、生成文件并安全响应。不依赖 Office,纯内存生成,适合高并发导出场景。
推荐库:github.com/xuri/excelize/v2
这是目前 Go 生态最成熟、维护活跃的 Excel 操作库,支持 .xlsx 格式(不支持旧版 .xls),功能覆盖单元格样式、公式、图表、多 Sheet、数据验证等。安装方式简单:
go get github.com/xuri/excelize/v2
注意使用 v2 版本(导入路径含 /v2),避免因版本混用导致 API 不兼容。
基础导出:从结构体切片生成表格
多数导出需求是从数据库查出结构体切片(如 []User),转成带表头的 Excel。关键步骤:
立即学习“go语言免费学习笔记(深入)”;
- 新建工作簿:
f := excelize.NewFile() - 获取默认 Sheet 名(通常是 "Sheet1"),或自定义:
index := f.NewSheet("用户列表") - 写入表头:用
f.SetCellValue("Sheet1", "A1", "姓名")或批量写入二维字符串切片 - 写入数据行:遍历结构体,按行列索引填值,例如
f.SetCellValue("Sheet1", fmt.Sprintf("A%d", i+2), user.Name) - 设置列宽(可选):
f.SetColWidth("Sheet1", "A", "D", 15) - 删除默认空白 Sheet(如果新增了 Sheet):
f.DeleteSheet("Sheet1")
最后调用 f.WriteToResponse(w, "users.xlsx") 直接写入 HTTP 响应流,避免临时文件。
提升体验:支持大文件与流式响应
导出万级数据时,全部加载到内存再写入易 OOM。Excelize 本身不原生支持“流式写入”,但可通过分批 + 手动 flush 缓解:
- 每写入 500 行,调用一次
f.Save()到 bytes.Buffer,再写入 response.Body(需提前设好 Content-Disposition 和 Content-Type) - 更稳妥做法:用 goroutine 预生成文件到磁盘临时路径,返回下载链接 + 定时清理(适合超大数据)
- 务必设置超时和限流,防止恶意请求拖垮服务
生产注意事项
上线前检查这几项:
- 中文内容确保使用 UTF-8 编码(Excelize 默认支持,无需额外处理)
- 日期字段用
time.Time转 Excel 序列值:excelize.ToExcelTime(t, false) - 数值类型避免传字符串(如 "123.45"),否则 Excel 会当文本处理,影响筛选/求和
- HTTP 接口加鉴权(如 JWT)、参数校验(如 limit ≤ 10000)、日志记录导出行为
- 前端建议加 loading 和失败重试,后端返回标准 JSON 错误(如 {“code”:500, “msg”:”生成失败”})
基本上就这些。不复杂但容易忽略细节,跑通一个用户导出示例,后面扩展订单、报表等都类似。










