必须先解析header建立字段名到索引的映射，再按名取值防错位；关键字段缺失则跳过并记日志；服务端须自主解析header，不可信前端顺序。
反射能实现通用 CSV 导入导出，但必须配合手动 header 映射和类型安全处理，否则字段错位、空值 panic、中文乱码会直接线上出问题。
csv.Reader 读取时字段顺序错位怎么防
Go 的 csv.Reader 不校验列名，只按位置赋值。如果 Excel 导出时拖动了列，或用户上传的 CSV 头行顺序和结构体字段声明顺序不一致，csv.Decode 会静默把邮箱塞进昵称字段，毫无报错。
- 必须先调用
r.Read()拿到 header 行，再用map[string]int建立列名到索引的映射，例如：colIndex["email"] = 2 - 后续每行用
row[colIndex["email"]]取值，彻底脱离位置依赖 - 关键字段（如
email）缺失时直接跳过该行并打日志，别让脏数据进库 - 别信前端传来的字段顺序，服务端必须自己解析 header
用 reflect 实现通用导出时字段不可见怎么办
反射只能访问导出字段（首字母大写）。像 bn_id 这种小写开头的字段，reflect.Value.Field(i) 根本读不到值，返回零值且无提示——这是最常被忽略的翻车点。
- 结构体字段必须首字母大写，且加
csvtag，例如：UserID int `csv:"user_id"` - 导出前先用
reflect.TypeOf遍历字段，检查是否导出；未导出字段直接跳过，不 panic - 字段值为
nil（如*string）时，reflect.Value.Interface()会 panic，得先.IsValid()判空 - 时间、布尔、数字等类型需显式转
string，不能直接丢给w.Write()
中文乱码和空字段导致写入失败怎么解
CSV 文件没 BOM，Excel 默认当 ANSI 解，中文全变方块；空字段不处理，csv.Writer 会因 FieldsPerRecord 校验失败直接报错。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
立即学习“go语言免费学习笔记（深入）”；
- 导出第一行前，手动写入 UTF-8 BOM：
w.Write([]byte("\xEF\xBB\xBF")) - 设置
r.FieldsPerRecord = -1，允许某行字段数不同（比如空字段被省略） - 写入前对每个字段做
strings.TrimSpace，再判空；空字符串可转成""或保留原样，但不能传nil - HTTP 下载响应头必须设全：
Content-Type: text/csv; charset=utf-8和Content-Disposition: attachment; filename="data.csv"
大文件流式处理时内存爆掉怎么控
一次性 ReadAll 几万行 CSV，字段含 base64 图片时，几百 MB 内存瞬间吃光；用 reflect 动态取字段又加重 GC 压力。
- 永远用循环
r.Read()，每行解析完立刻入库或发到 channel，别攒全量 - 数据库批量插入用
INSERT INTO ... VALUES (), ()，每 100–500 行 commit 一次事务 - 高频导出场景下，别每次调
reflect，预生成字段名列表 + getter 函数数组，避免重复反射开销 - 调整
csv.NewReader底层bufio.Reader缓冲区大小，大字段多时设为64 * 1024
真正难的不是写通反射逻辑，而是 header 映射的健壮性、空值与零值的区分、以及流式过程中错误行的精确定位——这些地方一松懈，导入任务就卡在第 1234 行，日志里却只有一句 “parse error”。
