csv.Reader漏第一行是因误调一次Read()丢弃结果；写CSV需手动加UTF-8 BOM（\xEF\xBB\xBF）防中文乱码；struct转CSV须反射提取字段并处理导出限制；读大文件应流式处理避免OOM。

csv.Reader 读取时为什么总漏掉第一行？

因为 csv.NewReader 本身不自动跳过表头，它只负责按行解析；漏掉第一行往往是调用了 reader.Read() 一次又没保存结果，误以为那是“跳过”逻辑。

• 正确做法是：用 reader.Read() 显式读一次获取表头，再进循环读数据行
• 如果真想跳过，就别把第一次 Read() 的结果丢弃——哪怕只是存成 header 变量
• 注意 Read() 返回的是 []string，不是结构体；字段顺序完全依赖 CSV 原始列序
• 遇到空行或只有逗号的行，Read() 会返回 nil 错误，需检查 err == io.EOF 来判断结束

写 CSV 时中文乱码、Excel 打不开怎么办？

根本原因是没加 UTF-8 BOM，Windows 下 Excel 默认用 ANSI 解码 CSV，看到中文就崩。

• 必须在写入内容前，先写入 BOM 字节：write([]byte("\xEF\xBB\xBF"))
• csv.Writer 本身不处理编码，它只写 []byte；BOM 要手动塞在最开头
• 不要用 os.Create 后直接套 csv.NewWriter 就完事，得包一层 io.Writer 并提前写 BOM
• 如果数据里含换行符（\n）或双引号，Write() 会自动加引号和转义——这是标准行为，别手动拼字符串

如何把 struct 字段名自动当 CSV 表头？

encoding/csv 不支持反射自动映射，得自己做字段提取和顺序对齐。

Golang Uber Dig

使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等

下载

• 用 reflect.TypeOf 遍历 struct 字段，读 csv tag（如 `csv:"name"`），没 tag 就用字段名小写
• 写表头时按字段声明顺序输出，写数据行时按同样顺序取 reflect.Value 的值
• 注意导出限制：只有首字母大写的字段才能被 reflect 读到；小写字段会被忽略
• 性能敏感场景慎用反射——每行都反射比预定义 []string 切片慢 3–5 倍

读大文件时内存暴涨甚至 OOM 怎么办？

常见错误是把所有 Read() 结果全 append 进一个大 slice，而不是流式处理。

立即学习“go语言免费学习笔记（深入）”；

• 别用 for record := range records（这需要先把全部行读进内存）；坚持用 for { record, err := reader.Read() } 循环
• 每次 Read() 返回的 []string 是复用底层缓冲的，但如果你把它存进 map/slice，就得显式 append 拷贝，否则后续 Read() 会覆盖
• 用 reader.FieldsPerRecord = -1 允许每行字段数不同，避免某行多一列就整个 panic
• 超大文件建议配合 bufio.NewReaderSize(file, 1<<20) 提升 IO 效率，但别设太大（比如 100MB），会拖慢 GC

CSV 看似简单，但字段类型模糊、BOM 缺失、换行嵌套、空行容错这些细节，全靠手动补位。别指望库替你猜语义——它只管分隔符和引号，其余全是你的责任。