csv.NewReader读空需先检查文件指针是否归零（file.Seek(0,0)）及UTF-8 BOM（\xEF\xBB\xBF）是否干扰；BOM需用bytes.TrimPrefix预处理，不可用strings.ReplaceAll；第一行“消失”因reader不自动跳header，需显式读取或截取；写入中文须手动写BOM并调Flush()；大文件应避免ReadAll/WriteAll，改用流式读写并注意字段转义与内存控制。
csv.NewReader 读出来是空的？先检查文件指针和 BOM
直接 csv.NewReader(file).Read() 返回空或立即 io.EOF，大概率不是代码写错，而是文件没从头开始读，或者开头有 UTF-8 BOM（\xEF\xBB\xBF）被当成非法字符卡住。
- 调过
file.Stat()、io.ReadAll(file)或其他预读操作后，*os.File的内部偏移已改变 —— 解决办法：创建 reader 前加file.Seek(0, 0) - Windows 记事本或 Excel 导出的 CSV 常带 BOM，
csv.NewReader不会自动跳过 —— 推荐用bytes.TrimPrefix(buf, []byte("\xef\xbb\xbf"))预处理原始字节，再传给bytes.NewReader - 别用
strings.ReplaceAll删 BOM —— 它可能误删字段内真实存在的\xEF\xBB\xBF字节序列，破坏 UTF-8 编码
为什么第一行总“消失”？reader.Read() 不自动跳 header
csv.Reader 本身不区分表头和数据行，所谓“漏第一行”，八成是你手动调了一次 reader.Read() 却没保存结果，误当成了“跳过逻辑”。
- 想保留表头：先
header, _ := reader.Read()，再进循环读数据行 - 想跳过表头：显式调一次
_, _ = reader.Read()，但别丢在 if 条件里不执行 - 用
reader.ReadAll()时，header 也在返回结果里 —— 需自己截掉首行，而不是指望库帮你识别 - 字段顺序完全依赖原始列序，
record[0]就是第一列，别假设它对应结构体某个 tag
写入中文到 CSV，Excel 打不开？BOM 和 Flush 缺一不可
Go 字符串原生是 UTF-8，写入中文本身不会乱码；但 Windows Excel 默认用 ANSI 解码无 BOM 的 UTF-8 文件，结果全是问号或方块。
- 必须在写任何内容前，向底层
*os.File或bytes.Buffer写入 BOM：w.Write([]byte("\xef\xbb\xbf")) -
csv.Writer自身不处理编码，也不自带 BOM —— 这一步纯手动，且只能写一次，放在w.Write(header)之前 - 写完必须调
w.Flush()—— 否则最后一两行永远滞留在缓冲区，进程退出时直接丢失 - 字段含逗号、换行、双引号？放心交给
w.Write([]string{"a,b", "c\nd", `he said "hi"`})，它会自动包裹和转义，别拼字符串
大文件读写内存爆满？别碰 ReadAll/WriteAll
ReadAll() 把整个 CSV 加载进内存，100MB 文件实际可能吃掉 400MB+ 内存；WriteAll() 同样不刷新缓冲区，最后一段数据常丢。
立即学习“go语言免费学习笔记（深入）”；
- 生产环境一律用流式读：
for { record, err := reader.Read(); if err == io.EOF { break }; if err != nil { /* 处理错误 */ }; /* 处理 record */ } - 每次
reader.Read()复用底层缓冲，但如果你把recordappend 到 slice 或存进 map，就得显式拷贝：append([]string(nil), record...) - 设置
reader.FieldsPerRecord = -1可禁用字段数校验，避免某行多一列就 panic，但后续逻辑得自己容错 - 超大文件建议配合
bufio.NewReaderSize(file, 64*1024)提升 IO 效率，但 buffer 别设太大（如 100MB），GC 会拖慢
BOM 是否存在、文件指针是否归零、Flush() 是否调用、Read() 错误是否判全 —— 这四点漏掉任一个，CSV 操作就会在看似最简单的地方翻车。
