csv.NewWriter必须包装*os.File或http.ResponseWriter等支持流式写入的io.Writer，不接受[]byte；Write()只收[]string，需手动转字符串；Flush()必须显式调用，否则数据丢失；HTTP导出需设正确响应头和UTF-8 BOM。
csv.NewWriter 必须包装 *os.File 或 http.ResponseWriter，不能直接写 []byte
Go 的 csv.Writer 是带缓冲的写入器，它不接受原始字节切片，也不兼容 io.Writer 的任意实现——必须用 os.File、http.ResponseWriter 或其他实现了 Write([]byte) (int, error) 且支持流式写入的类型。常见错误是试图把 bytes.Buffer 或自定义结构体强转过去，结果编译失败或运行时 panic。
正确做法是：
- 导出文件：用
os.Create("data.csv")得到*os.File，再传给csv.NewWriter() - HTTP 下载：直接传
http.ResponseWriter，但必须在调用Write()前设置好响应头 - 测试或中间处理：可用
bytes.Buffer，但它要先显式转换为io.Writer（csv.NewWriter(buf)合法），只是最终仍需buf.Bytes()获取内容，不能替代真实文件写入逻辑
Write() 只收 []string 或 []interface{}，nil/bool/time.Time 会 panic
csv.Writer.Write() 接口签名是 func (w *Writer) Write(record []string) error，它内部不做类型断言或自动转换。如果误传 []interface{} 里含 nil、bool、time.Time 等非字符串值，要么 panic，要么输出不可读内容（比如 {0 0}）。
安全写法：
立即学习“go语言免费学习笔记（深入）”；
- 所有字段必须提前转成字符串：用
strconv.Itoa转数字，t.Format("2006-01-02")转时间，空值统一用"" - 结构体导出不要依赖反射自动映射——标准库完全忽略
csv:"name"标签，得手动取字段值拼[]string - 别用
fmt.Sprintf拼接整行再拆，既绕过转义又易出错；csv.Writer的价值就在自动处理"hello, world"和"a\"b"
Flush() 不是可选项，是数据落盘/响应完成的必要步骤
csv.Writer 默认缓冲区 4KB，不调 Flush() 就退出程序，最后一块数据永远卡在内存里。HTTP 场景下更明显：没 Flush()，浏览器可能等超时、只收到部分数据、甚至直接渲染成页面文本而非触发下载。
关键细节：
- 用
defer writer.Flush()不够可靠——如果中间发生 panic，defer可能不执行；建议在所有Write()后显式调一次，最后再补一次 -
WriteAll()内部会调Flush()，但仅限本次调用范围；后续追加写仍需自己Flush() - 检查错误别只看
Write()：调完Flush()后务必查writer.Error()，它汇总了缓冲期内所有写失败
中文乱码、Excel 打不开、文件名变 download.csv —— 全是响应头和 BOM 没配对
HTTP 导出 CSV 时，三个地方错一个，前端就崩：
-
Content-Type必须设为text/csv; charset=utf-8，漏掉charset=utf-8，Chrome 可能按 ISO-8859-1 解析中文 -
Content-Disposition的filename值要用英文双引号包裹，且不能含路径或特殊字符；推荐写法：attachment; filename="data.csv"（用反引号或转义避免 Go 字符串解析问题） - Windows Excel 默认不认纯 UTF-8，得在文件开头写 BOM：
file.Write([]byte("\xef\xbb\xbf"))，这步必须在csv.NewWriter创建前做，否则 BOM 被当成第一行数据
最常被跳过的其实是 BOM —— 它不解决乱码，只解决 Excel 的自动编码识别；而服务端响应头没设对，连浏览器都打不开正确编码。
