0

0

如何在Golang中解析CSV与Excel文件 Go语言结构化数据I/O处理

P粉602998670

P粉602998670

发布时间:2026-03-13 17:19:31

|

418人浏览过

|

来源于php中文网

原创

Go解析CSV和Excel需分别处理:csv.Reader需设TrimLeadingSpace、跳空行;excelize推荐替代tealeg/xlsx,应跳过样式公式、校验sheet存在、用ColumnNumberToName防越界,且二者struct标签不兼容,不宜强求统一。

如何在golang中解析csv与excel文件 go语言结构化数据i/o处理

encoding/csv 读 CSV 时字段错位或空行不处理

Go 标准库的 csv.Reader 默认把空行当普通记录,且不跳过注释行或 BOM;一旦源文件有 Excel 导出常见的首行空格、尾部逗号、引号嵌套异常,Read() 就会返回 error: bad record 或字段数量对不上。

实操建议:

立即学习go语言免费学习笔记(深入)”;

  • 初始化 csv.Reader 后立即调用 r.Comma = ';'(如遇分号分隔)或 r.TrimLeadingSpace = true,避免首尾空格干扰字段对齐
  • for record, err := r.Read(); err == nil; record, err = r.Read() 循环,但必须在循环内加 if len(record) == 0 { continue } 跳过空行
  • 若 CSV 含 Excel 风格双引号转义(如 "a""b" 表示 a"b),标准库不支持——得换 gocsv 或手动预处理字符串
  • 注意 ReadAll() 会一次性加载全部内容到内存,百万行 CSV 容易 OOM;大文件务必用流式 Read()

解析 Excel(.xlsx)必须用第三方库,tealeg/xlsx 已停更

Go 没有官方 Excel 支持,tealeg/xlsx 曾是主流,但自 2019 年起不再维护,解析含公式、合并单元格或新 Excel 格式(如 .xlsb)会 panic 或静默丢数据。

实操建议:

立即学习go语言免费学习笔记(深入)”;

  • 现在推荐 qax-os/excelize: actively maintained,支持读写 xlsx/xlsb/ods,能处理样式、公式、图片(虽公式值需额外调用 CalcCellValue
  • 打开文件后别直接 f.GetSheetList() 就遍历——先确认 f.GetSheetName(0) 是否存在,否则索引越界报 index out of range
  • 读单元格用 f.GetCellValue("Sheet1", "A1") 最安全;若用行列索引 f.GetCellValue("Sheet1", "A1") 等价于 f.GetCellValue("Sheet1", "A1"),但列名计算别手写 string(rune('A') + col),容易越界,应改用 excelize.ColumnNumberToName(col+1)
  • Excel 日期是浮点天数(1900-01-01 起),GetCellValue 返回的是字符串格式化后的值;要原始数值,得用 f.GetCellFloat("Sheet1", "A1") 再转 time.Time

CSV 和 Excel 共用结构体时,标签(tag)写法差异大

想用同一 struct 解析两种格式?csv tag 和 excelize tag 不兼容:encoding/csv 只认 csv:"name",而 excelize 默认按列顺序映射,需显式用 xlsx:"col:1"xlsx:"name" 配合 SetStructTag

Rose.ai
Rose.ai

一个云数据平台,帮助用户发现、可视化数据

下载

实操建议:

立即学习go语言免费学习笔记(深入)”;

  • 不要强求单 struct 通吃——CSV 通常按 header 名匹配,Excel 常按固定列位置读,二者语义不同,硬统一反而增加歧义
  • 若坚持复用,定义 struct 时同时写两种 tag:type User struct { Name string `csv:"name" xlsx:"col:1"` },但要注意 excelizecol:1 是从 1 开始,csvname 是 header 文本,大小写必须完全一致
  • Excel 读取时若列顺序不固定,别依赖 col:x,改用 xlsx:"name" 并确保第一行是 header,再调用 f.GetSheetRow("Sheet1", 1) 手动找列索引
  • struct 字段类型要和实际数据对齐:CSV 数字字段声明为 int 却遇到空字符串,UnmarshalCSV 会报错;建议全用 string 接收,后续再 strconv.Atoi

性能关键点:小文件无所谓,大 Excel 文件务必关掉样式和公式解析

excelize 默认加载所有样式、条件格式、公式依赖树,一个 10MB 的 Excel(含图表和样式)可能占用 500MB 内存、解析耗时 3 秒以上;而纯数据表其实只需要单元格值。

实操建议:

立即学习go语言免费学习笔记(深入)”;

  • 打开文件时传入选项:f, err := excelize.OpenFile("data.xlsx", excelize.Options{SkipFormula: true, SkipStyle: true})
  • 如果只读某几列,别用 f.GetRows() 全量加载——改用 f.GetSheetMap() 获取 sheet 名列表,再逐行 f.GetRow("Sheet1", i),配合 break 提前退出
  • CSV 流式读取中做字段校验(比如检查邮箱格式)比全读进内存再校验省 60%+ 时间;但别在 Read() 循环里反复调用 regexp.MustCompile,应提前编译好 var emailReg = regexp.MustCompile(`^.+@.+\..+$`)
  • 并发解析多个文件?注意 excelize*File 实例不是 goroutine-safe 的,每个 goroutine 必须新建实例,不能复用

Excel 解析最麻烦的从来不是读不到数据,而是你没意识到那个“看起来只是个表格”的文件里,藏着 3 层嵌套的条件格式、17 个隐藏工作表,还有被保护但没密码的工作表——它不会报错,只会默默跳过。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
golang如何定义变量
golang如何定义变量

golang定义变量的方法:1、声明变量并赋予初始值“var age int =值”;2、声明变量但不赋初始值“var age int”;3、使用短变量声明“age :=值”等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

211

2024.02.23

golang有哪些数据转换方法
golang有哪些数据转换方法

golang数据转换方法:1、类型转换操作符;2、类型断言;3、字符串和数字之间的转换;4、JSON序列化和反序列化;5、使用标准库进行数据转换;6、使用第三方库进行数据转换;7、自定义数据转换函数。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

247

2024.02.23

golang常用库有哪些
golang常用库有哪些

golang常用库有:1、标准库;2、字符串处理库;3、网络库;4、加密库;5、压缩库;6、xml和json解析库;7、日期和时间库;8、数据库操作库;9、文件操作库;10、图像处理库。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

356

2024.02.23

golang和python的区别是什么
golang和python的区别是什么

golang和python的区别是:1、golang是一种编译型语言,而python是一种解释型语言;2、golang天生支持并发编程,而python对并发与并行的支持相对较弱等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

214

2024.03.05

golang是免费的吗
golang是免费的吗

golang是免费的。golang是google开发的一种静态强类型、编译型、并发型,并具有垃圾回收功能的开源编程语言,采用bsd开源协议。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

409

2024.05.21

golang结构体相关大全
golang结构体相关大全

本专题整合了golang结构体相关大全,想了解更多内容,请阅读专题下面的文章。

490

2025.06.09

golang相关判断方法
golang相关判断方法

本专题整合了golang相关判断方法,想了解更详细的相关内容,请阅读下面的文章。

201

2025.06.10

golang数组使用方法
golang数组使用方法

本专题整合了golang数组用法,想了解更多的相关内容,请阅读专题下面的文章。

1479

2025.06.17

TypeScript类型系统进阶与大型前端项目实践
TypeScript类型系统进阶与大型前端项目实践

本专题围绕 TypeScript 在大型前端项目中的应用展开,深入讲解类型系统设计与工程化开发方法。内容包括泛型与高级类型、类型推断机制、声明文件编写、模块化结构设计以及代码规范管理。通过真实项目案例分析,帮助开发者构建类型安全、结构清晰、易维护的前端工程体系,提高团队协作效率与代码质量。

26

2026.03.13

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Go 教程
Go 教程

共32课时 | 6.2万人学习

Go语言实战之 GraphQL
Go语言实战之 GraphQL

共10课时 | 0.9万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号