导出函数必须接收io.Writer而非文件路径，以解耦I/O目标、支持HTTP响应、内存缓冲和测试；正确签名如func Export(data []Record, format string, w io.Writer) error，并校验w非nil。
导出函数要不要接收 io.Writer 而不是文件路径
直接写死文件路径会让模块耦合磁盘 I/O，无法用于 HTTP 响应流、内存缓冲或测试场景。必须把输出目标抽象为 io.Writer 接口，这是 Go 的惯用做法。
常见错误是定义成 func ExportToCSV(filename string)，结果没法导出到 http.ResponseWriter 或 bytes.Buffer。
- 正确签名示例：
func Export(data []Record, format string, w io.Writer) error -
format参数建议限定为"csv"、"json"、"xlsx"等明确字符串，避免传入任意字符串导致 panic - 如果调用方传入
nil的w，函数应立即返回errors.New("writer is nil")，不继续执行
JSON 和 CSV 导出共用同一套数据结构是否安全
可以，但要注意字段标签和零值处理。Go 的 json 和 csv 包对 struct tag 的处理逻辑不同，容易漏掉字段或导出空列。
比如 type Record struct { Name string `json:"name" csv:"name"` } 是基础要求；但若字段是 int 类型且值为 0，CSV 会照常输出 0，而 JSON 默认也会输出，但某些前端可能误判为“未填写”。
立即学习“go语言免费学习笔记（深入）”；
- 统一用指针类型（如
*string、*int）可区分“零值”和“未设置”，但会增加内存分配和解引用开销 - CSV 导出时，
encoding/csv不支持嵌套结构，扁平化必须提前做；JSON 则天然支持嵌套 - 若需导出时间字段，
time.Time在 JSON 中默认序列化为 RFC3339 字符串，但在 CSV 中需显式调用.Format()，否则输出的是 Go 默认字符串（含 location 信息，不易读）
Excel（.xlsx）导出为什么不能只靠 encoding/csv 生成 .xlsx 文件名
把 CSV 内容写进 report.xlsx 文件，只是改了后缀——Excel 打开会报错或显示乱码。真正的 xlsx 是 ZIP 容器格式，包含 XML 工作表、样式、共享字符串等。
必须用专门库，主流选型是 tealeg/xlsx（已归档但稳定）或更活跃的 qax-os/excelize。后者支持流式写入、公式、样式，且无 CGO 依赖。
- 注意
excelize的f.Write方法会一次性写入整个工作簿，不适合超大数据量；大表建议分批写入 +f.Save后续追加（实际不支持），所以得预估行数或改用流式 CSV 替代 - 若导出含中文，务必在创建 sheet 后调用
f.SetColWidth("Sheet1", "A", "Z", 20)并设置单元格样式字体（如f.SetCellStyle配合f.NewStyle(&excelize.Style{Font: &excelize.Font{Family: "Arial Unicode MS"}})），否则 Excel 可能显示方块 - 不要在导出函数里调用
f.Save("output.xlsx")，这又绑死了路径；应调用f.Write(w)，让调用方控制输出目标
如何避免导出时 panic：格式注册与 fallback 机制
用户传入未知 format 字符串（如 "xml" 或拼写错误的 "cvs"）时，别直接 panic 或静默失败。应该有明确错误提示，并提供默认 fallback（比如降级为 CSV）或返回可识别错误。
- 推荐用 map 预注册格式处理器：
var exporters = map[string]func([]Record, io.Writer) error{"csv": exportCSV, "json": exportJSON, "xlsx": exportXLSX} - 检查
exporters[format]是否为 nil，是则返回fmt.Errorf("unsupported format: %s", format) - 不要用
switch硬编码所有 case，否则新增格式要改两处（注册 + switch）；map 注册更易维护 - 测试时故意传
"yaml"，确认返回的是具体错误而非 panic 或空响应
最易被忽略的是错误传播：CSV 写入时遇到 io.ErrShortWrite，Excelize 写入时遇到 zip.ErrFormat，这些底层错误必须原样或包装后返回，不能吞掉。调用方需要知道是磁盘满、网络中断，还是数据本身非法。
