Go语言中encoding/csv包用于读写CSV文件，支持写入多行数据、处理特殊字符、自定义分隔符及从结构体切片生成CSV。1. 创建文件并使用csv.NewWriter写入表头和记录；2. Write和WriteAll方法自动处理含逗号、引号的字段；3. 设置Comma字段可改为制表符分隔（TSV）；4. 结构体需手动转为字符串切片写入；5. 必须调用Flush确保数据落盘。标准库适用于大多数场景，复杂需求可用第三方库增强。
在Go语言中，encoding/csv 包提供了对CSV（逗号分隔值）文件的读写支持。使用它写入CSV文件非常直观，适合处理表格数据，比如导出日志、生成报表或保存结构化信息。下面通过实际示例演示如何正确使用该包将数据写入CSV文件。
创建并写入CSV文件
要写入CSV文件，需要先创建一个文件句柄，然后使用 csv.NewWriter 创建一个写入器，接着调用 Write 或 WriteAll 方法写入记录。
示例：写入多行数据到 CSV 文件
package main
import (
"encoding/csv"
"os"
)
func main() {
// 创建文件
file, err := os.Create("users.csv")
if err != nil {
panic(err)
}
defer file.Close()
// 创建 CSV 写入器
writer := csv.NewWriter(file)
defer writer.Flush()
// 写入表头
header := []string{"Name", "Age", "Email"}
if err := writer.Write(header); err != nil {
panic(err)
}
// 写入多行数据
records := [][]string{
{"Alice", "25", "alice@example.com"},
{"Bob", "30", "bob@example.com"},
{"Charlie", "35", "charlie@example.com"},
}
if err := writer.WriteAll(records); err != nil {
panic(err)
}
}
运行后会生成 users.csv，内容如下：
Name,Age,Email Alice,25,alice@example.com Bob,30,bob@example.com Charlie,35,charlie@example.com
处理包含特殊字符的数据
CSV 标准支持字段中包含逗号、换行符或引号，encoding/csv 会自动处理这些情况，只需传入原始字符串即可。
立即学习“go语言免费学习笔记（深入）”；
例如：
record := []string{"Smith, John", "28", `"Engineer" at XYZ`}
writer.Write(record)
生成的CSV会自动用双引号包裹包含特殊字符的字段：
"Smith, John",28,"""Engineer"" at XYZ"
无需手动添加引号，Write 方法会按规范转义。
自定义分隔符（如制表符TSV）
如果需要写入以制表符分隔的文件（TSV），可以修改 Writer 的 Comma 字段。
示例：写入 TSV 文件
file, _ := os.Create("data.tsv")
writer := csv.NewWriter(file)
writer.Comma = '\t' // 设置分隔符为制表符
writer.Write([]string{"Name", "City"})
writer.Write([]string{"Alice", "Beijing"})
writer.Flush()
file.Close()
这样生成的就是标准的 TSV 文件，适用于某些系统或工具的导入需求。
从结构体切片写入CSV
实际开发中，数据通常来自结构体。虽然 encoding/csv 不直接支持结构体标签，但可以手动转换。
示例：
type User struct {
Name string
Age int
Email string
}
users := []User{
{"Alice", 25, "alice@example.com"},
{"Bob", 30, "bob@example.com"},
}
writer := csv.NewWriter(file)
writer.Write([]string{"Name", "Age", "Email"}) // 表头
for _, u := range users {
record := []string{u.Name, fmt.Sprintf("%d", u.Age), u.Email}
writer.Write(record)
}
writer.Flush()
注意：需手动将非字符串字段（如 int）转为字符串。
基本上就这些。encoding/csv 使用简单，关键是记得调用 Flush 确保数据写入磁盘，并合理处理错误。对于更复杂的场景（如自动结构体映射），可考虑第三方库如 github.com/gocarina/gocsv，但标准库已足够应对大多数基础写入任务。
