Go 中读取 CSV 文件最标准方式是使用 encoding/csv 包,需用 os.Open 打开文件并创建 csv.Reader,支持自动处理引号、转义和换行;推荐逐行 Read() 解析,可跳过表头、映射字段名或解析为结构体。

在 Go 中读取 CSV 文件,最标准、最可靠的方式是使用标准库中的 encoding/csv 包。它能正确处理带引号、换行符、逗号转义等复杂 CSV 场景,比手动字符串分割安全得多。
打开文件并创建 CSV reader
先用 os.Open 打开文件,再将文件句柄传给 csv.NewReader。注意检查错误,尤其是文件不存在或权限不足的情况。
- 确保文件路径正确,推荐使用绝对路径或基于当前工作目录的相对路径
- 如果 CSV 使用非 UTF-8 编码(如 GBK),需先用
golang.org/x/text/encoding转码,encoding/csv本身只支持 UTF-8 - 可选:调用
reader.Comma = ';'改为分号分隔(兼容某些欧洲格式)
逐行读取记录(推荐用于大文件)
对多数场景,尤其文件较大时,应使用 Read() 循环读取每一行,避免一次性加载全部内容到内存。
- 每次调用
r.Read()返回一个[]string,每个元素对应一列的值(已自动去除引号、还原转义) - 遇到空行会返回
nil, nil;遇到 EOF 会返回nil, io.EOF;解析出错则返回具体错误(如列数不一致) - 建议在外层用
for循环配合err == nil判断,而非仅检查err == io.EOF
跳过表头并映射字段名
若 CSV 含表头(第一行为字段名),可先读一次获取 header,后续每行用 map[string]string 关联字段名与值。
立即学习“go语言免费学习笔记(深入)”;
- 调用一次
r.Read()获取 header 切片,例如[]string{"name", "age", "city"} - 后续每行读出后,用
for i, v := range record { m[header[i]] = v }构建映射 - 注意字段名大小写和空格——CSV 表头常含多余空格,可用
strings.TrimSpace预处理
解析为结构体(适合固定格式)
若每行语义明确且结构稳定,定义 struct 并手动赋值更清晰、类型安全。标准库不直接支持 tag 映射(如 csv:"name"),需自行桥接。
- 先读 header,建立列名 → struct 字段索引的映射(如
map[string]int{"name": 0, "age": 1}) - 读每行时,按索引取值并转换类型:
age, _ := strconv.Atoi(record[idx["age"]]) - 可封装为通用函数,传入 struct 类型和 header,利用反射自动绑定(但小项目中直接手写更轻量、易调试)










