Go语言中encoding/csv包用于高效处理CSV文件，支持读取和写入操作。首先使用csv.NewReader读取数据，可调用ReadAll一次性读取或Read逐行读取以节省内存；示例展示了从字符串读取CSV并输出各行内容。接着通过csv.NewWriter写入数据到缓冲区或文件，需调用Flush确保数据写入，并检查Error方法获取错误信息。处理中文时默认支持UTF-8，若源文件为GBK等编码，需借助golang.org/x/text/encoding/simplifiedchinese进行解码转换。对于非逗号分隔的CSV，可通过设置Reader或Writer的Comma字段来自定义分隔符，如分号或制表符。综上，只需注意编码、分隔符及Flush操作，即可稳定处理各类CSV场景。
在 Go 语言中，encoding/csv 包提供了处理 CSV（逗号分隔值）文件的简单而高效的方式。无论是读取用户上传的数据、导出报表，还是与其他系统交换数据，CSV 都是常见格式。本文将通过实际示例展示如何使用该包进行 CSV 数据的解析与写入。
读取 CSV 文件
要从文件或字符串中读取 CSV 数据，可以使用 csv.NewReader 创建一个读取器，然后调用其 ReadAll 或逐行读取 Read 方法。
示例：从字符串读取 CSV 数据
package main
import (
"encoding/csv"
"fmt"
"strings"
)
func main() {
csvData := `姓名,年龄,城市
张三,25,北京
李四,30,上海
王五,28,深圳`
reader := csv.NewReader(strings.NewReader(csvData))
records, err := reader.ReadAll()
if err != nil {
fmt.Println("读取失败:", err)
return
}
for i, record := range records {
fmt.Printf("第%d行: %v\n", i+1, record)
}
}
输出结果：
立即学习“go语言免费学习笔记（深入）”；
第1行: [姓名 年龄 城市]第2行: [张三 25 北京]
第3行: [李四 30 上海]
第4行: [王五 28 深圳]
如果数据量较大，建议逐行读取以节省内存：
for {
record, err := reader.Read()
if err == io.EOF {
break
}
if err != nil {
fmt.Println("读取出错:", err)
break
}
fmt.Println(record)
}
写入 CSV 文件
使用 csv.NewWriter 可将数据写入文件或缓冲区。写入后记得调用 Flush 确保数据落盘。
示例：写入 CSV 到字符串缓冲区
package main
import (
"encoding/csv"
"fmt"
"strings"
)
func main() {
var buf strings.Builder
writer := csv.NewWriter(&buf)
// 写入表头
writer.Write([]string{"姓名", "年龄", "城市"})
// 写入数据行
writer.Write([]string{"赵六", "32", "广州"})
writer.Write([]string{"钱七", "29", "杭州"})
// 必须调用 Flush
writer.Flush()
if err := writer.Error(); err != nil {
fmt.Println("写入失败:", err)
return
}
fmt.Println(buf.String())
}
若要写入文件，只需将 *os.File 传给 NewWriter：
file, _ := os.Create("output.csv")
defer file.Close()
writer := csv.NewWriter(file)
// ... 写入逻辑
writer.Flush()
处理中文与编码问题
CSV 本身不包含编码信息，Go 的 encoding/csv 默认处理 UTF-8。如果源文件是 GBK 或其他编码，需先转换为 UTF-8。
例如使用 golang.org/x/text/encoding/simplifiedchinese 处理 GBK 编码文件：
import (
"golang.org/x/text/encoding/simplifiedchinese"
"golang.org/x/text/transform"
)
file, _ := os.Open("data.csv")
defer file.Close()
decoder := simplifiedchinese.GBK.NewDecoder()
reader := csv.NewReader(transform.NewReader(file, decoder.Transform()))
records, _ := reader.ReadAll()
这样可避免中文乱码问题。
自定义分隔符
并非所有“CSV”都用逗号，有些使用制表符或分号。可通过设置 Comma 字段修改分隔符。
示例：读取以分号分隔的 CSV
reader := csv.NewReader(strings.NewReader(data)) reader.Comma = ';' // 设置分隔符为分号 records, _ := reader.ReadAll()
同样适用于写入：
writer := csv.NewWriter(&buf) writer.Comma = '\t' // 使用制表符
基本上就这些。encoding/csv 虽然简单，但足够应对大多数场景。只要注意编码、分隔符和 Flush，就能稳定处理 CSV 数据。
