使用 Go 读取 CSV

CSV 简介

CSV(Comma-Separated Values )格式是一种纯文本数据格式,用于以表格的形式存储数据。

它的语法规则是:

  • 每一行代表一条记录(row)
  • 每一列之间用英文逗号 "," 分隔(列字段)
  • 每一行之间用换行符分隔。这里通常无需考虑 \n 和 \r\n 的区别,因为大多数 CSV 解析器(包括 Go 的 encoding/csv 包)都能自动处理这两种换行。
  • 没有定义表头的概念(用户通常默认第一行是 表头)
  • 文件扩展名是 .csv

🌰 一个 CSV 文件的例子

csv 复制代码
name,age,city
Alice,30,Beijing
Bob,25,Shanghai

读取 CSV

csv package - encoding/csv - Go Packages

要读取一个 CSV,我们首先得创建一个专门读 CSV 的 Reader 。这个 Reader 的特点在于,它每次能读取 CSV 的一行。方法如下:

go 复制代码
func NewReader(r io.Reader) *Reader

通常情况下,CSV 都来自一个文件。所以就有了如下范式:

go 复制代码
file, err := os.Open("data.csv")
if err != nil {
	panic(err)
}
defer file.Close()

reader := csv.NewReader(file)

▶️ 然后,我们就可以调用这个 Reader 的 Read 方法了。就像我们刚才所说的,它每次返回一行 CSV 数据。

go 复制代码
func (r *Reader) Read() (record []string, err error)

如果没有更多数据了,该方法就会返回 nil, io.EOF 。

和很多 Reader 类似,这里也有 ReadAll 方法,不过它返回的不是 []byte,而是入乡随俗的 [][]string 。和其它 ReadAll 方法一样,这里读完后也不会返回 io.EOF 而是返回 nil 。

go 复制代码
func (r *Reader) ReadAll() (records [][]string, err error)

接下来,我们就直接能用 for range 来迭代它了。

🎈 注意:无论用哪个方法,读出来的数据都是字符串类型的。


📢 本文为原创文章,首发于掘金。

🚫 禁止任何形式的转载、摘编、改编,尤其是未经授权的商业使用。

相关推荐
Sailing3 小时前
🚀客户端都超时了,你的 Go 服务还在查库?Context 取消链路不打通,连接池迟早被打爆
后端·面试·go
小满zs15 小时前
Go语言第二十一章(Gin上传文件)
后端·go
我不会起名字32221 小时前
Agent 总调错工具?MCP 接进 Go 后端的 4 个约束
后端·go·agent·mcp
我不会起名字3223 天前
WebSocket 停机与在线状态:Shutdown 返回后还需要清理什么
redis·后端·websocket·go·即时通讯·im·故障排查
小满zs4 天前
Go语言第二十章(初探Gin)
后端·go
小满zs4 天前
Go语言第十九章(http标准库)
后端·go
我不会起名字3224 天前
仅 Web 主动 ping:30 秒读超时与各平台保活
前端·后端·websocket·go·即时通讯·im·故障排查
星星在线4 天前
Go + gRPC 插件式服务框架 —— 技术实现与分析
go
Java码农也是农4 天前
一篇文章讲清 Go 并发:goroutine、channel、select 与取消
go·并发编程·context·channel·goroutine
afumu5 天前
Go 写一个只监听 127.0.0.1 的控制服务:鉴权、白名单、危险命令拦截
后端·安全·go