CSV中文乱码根源是浏览器/Excel按系统默认编码（如GBK）解析UTF-8内容，因响应头缺charset声明且文件无BOM；修复需同时设置Content-Type为text/csv; charset=utf-8、写入前加UTF-8 BOM（\uFEFF），并确保换行符为\r\n。
导出 CSV 时中文乱码的根源和修复方式
Buffalo 默认使用 text/csv 响应头且不带字符编码声明，浏览器（尤其是 Excel）会按系统默认编码（如 GBK）解析 UTF-8 内容，导致中文显示为乱码。
解决的关键不是改文件名后缀，而是响应头和字节流的一致性：
- 必须在
Content-Type中显式加上; charset=utf-8 - 写入前用
bytes.BOMUTF8开头（即\uFEFF），Excel 才能正确识别 UTF-8 - 避免用
fmt.Fprintln直接写字符串——它不处理 BOM，也不保证换行符统一（Windows 下需\r\n）
示例片段：
c.Response().Header().Set("Content-Type", "text/csv; charset=utf-8")
c.Response().Header().Set("Content-Disposition", `attachment; filename="data.csv"`)
w := csv.NewWriter(c.Response())
w.Write([]string{"\uFEFFID", "姓名", "邮箱"}) // 第一行加 BOM
w.Write([]string{"1", "张三", "zhang@example.com"})
w.Flush()
导出 Excel（.xlsx）需要绕过 Buffalo 的自动渲染机制
Buffalo 的 c.Render() 会强制走模板流程并设置 HTML 相关响应头，无法直接输出二进制 Excel 文件。必须跳过中间件链中的渲染逻辑，手动控制响应体。
核心动作是：禁用自动渲染 + 设置正确 MIME 类型 + 直接写入 *xlsx.File 的字节流：
- 调用
c.Set("skip_render", true)阻止后续Render执行 - 用
application/vnd.openxmlformats-officedocument.spreadsheetml.sheet作为Content-Type - 用
f.Bytes()获取*xlsx.File的原始字节，再通过c.Response().Write()输出
注意：github.com/tealeg/xlsx 不支持流式写入，整张表需先构建在内存中；大数据量时务必加超时或分页提示。
Buffalo框架 1.0.1
下载
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
大表导出卡死或超时，怎么控制响应生命周期
Buffalo 默认请求超时由 Go HTTP Server 控制（通常 30 秒），而导出万级数据可能耗时更久。不能只调大全局超时——这会影响所有接口。
更稳妥的做法是在路由层单独配置长超时，并配合流式响应缓解内存压力：
- 注册导出路由时用
app.Get("/export", ExportHandler).DisableDefaultMiddleware()跳过Timeout中间件 - 用
io.Pipe创建读写端，启动 goroutine 异步生成数据，主线程持续从 pipe 读取并写入c.Response() - 务必在 goroutine 中 recover panic，否则 panic 会丢失，且 pipe 写端未 close 将导致客户端永久等待
流式导出不适用于 .xlsx（格式依赖 ZIP 结构封包），但对 CSV 完全可行。
导出按钮点击无反应或下载失败的常见排查点
前端发请求后没触发下载，多数不是后端逻辑问题，而是响应头或协议不匹配：
- 确认是否用了
fetch或axios——它们默认不处理Content-Disposition: attachment，需改用<a href="/export" download>或window.location.href - 检查是否启用了 CSRF 中间件：Buffalo 默认开启，而 GET 导出路由若被 CSRF 拦截，会返回 403 且无提示
- 确认路径是否带
.csv后缀：Buffalo 的自动格式协商（Accept头）可能误判为 HTML，强制加?format=csv或显式路由如/export.csv
最易忽略的是开发环境下热重载中间件干扰：某些自定义中间件在 dev 模式下会劫持响应体，建议导出逻辑独立成子路由并关闭无关中间件。
