1. 简介与库选择
在 go 语言中处理 excel 文件，通常需要借助第三方库。github.com/tealeg/xlsx 是一个功能强大且广泛使用的库，它提供了读取和写入 .xlsx 格式 excel 文件的能力。该库封装了底层的文件解析逻辑，使得开发者能够以结构化的方式访问 excel 文件中的数据，如工作表、行和单元格。
2. 安装 xlsx 包
在使用 xlsx 包之前，需要将其安装到 Go 项目中。打开终端或命令行工具，执行以下 go get 命令：
go get -v github.com/tealeg/xlsx
此命令会自动下载 xlsx 包及其所有依赖项，并将其安装到 Go 模块缓存中，以便在项目中引用。
3. 读取 Excel 文件的基本流程
使用 xlsx 包读取 Excel 文件的基本步骤包括：
- 导入必要的包：引入 xlsx 包以及标准库中的 fmt 和 log 包用于输出和错误处理。
- 打开 Excel 文件：使用 xlsx.OpenFile() 函数打开指定的 .xlsx 文件。
- 遍历工作表：Excel 文件可以包含多个工作表（Sheet），需要遍历这些工作表来访问其内容。
- 遍历行：在每个工作表中，数据以行的形式组织，需要逐行遍历。
- 遍历单元格：在每行中，数据存储在单元格（Cell）中，需要逐个访问单元格以提取其值。
- 提取单元格值：单元格的值可以通过其提供的方法（如 String()）转换为字符串或其他类型。
4. 示例代码：读取 Excel 文件内容
以下是一个完整的 Go 语言程序示例，演示了如何打开一个 Excel 文件，并打印出其中所有工作表、行和单元格的内容。
首先，请确保在运行此代码之前，在程序同一目录下创建一个名为 example.xlsx 的 Excel 文件，并填充一些数据，例如：
example.xlsx 内容示例：
Sheet1: | 姓名 | 年龄 | 城市 | | :--- | :--- | :--- | | 张三 | 30 | 北京 | | 李四 | 25 | 上海 |
Sheet2: | 产品 | 价格 | 数量 | | :--- | :--- | :--- | | 铅笔 | 2.5 | 100 | | 笔记本 | 15.0 | 50 |
Go 程序代码：
package main
import (
"fmt"
"log"
"github.com/tealeg/xlsx" // 导入 xlsx 包
)
func main() {
// 指定要读取的 Excel 文件路径
// 确保此文件存在于与Go程序相同的目录下或提供完整路径
filePath := "example.xlsx"
// 1. 打开 Excel 文件
// xlsx.OpenFile 返回一个 *File 对象和可能的错误
xlFile, err := xlsx.OpenFile(filePath)
if err != nil {
// 如果打开文件失败，使用 log.Fatalf 打印错误并退出程序
log.Fatalf("打开Excel文件失败: %v", err)
}
fmt.Printf("成功打开文件: %s\n\n", filePath)
// 2. 遍历文件中的所有工作表
// xlFile.Sheets 是一个 *Sheet 类型的切片
for _, sheet := range xlFile.Sheets {
fmt.Printf("--- 工作表: %s ---\n", sheet.Name)
// 3. 遍历当前工作表中的所有行
// sheet.Rows 是一个 *Row 类型的切片
for rowIndex, row := range sheet.Rows {
// 过滤掉可能存在的空行（如果需要）
if row == nil {
continue
}
// 打印当前行号（rowIndex 从 0 开始，所以加 1）
fmt.Printf(" 行 %d: ", rowIndex+1)
// 4. 遍历当前行中的所有单元格
// row.Cells 是一个 *Cell 类型的切片
for colIndex, cell := range row.Cells {
// 5. 获取单元格的字符串值
// cell.String() 方法返回单元格内容的字符串表示
text := cell.String()
fmt.Printf("列 %d: %s | ", colIndex+1, text)
}
fmt.Println() // 每一行结束后换行
}
fmt.Println() // 每个工作表结束后空一行，提高可读性
}
}
运行结果示例：
成功打开文件: example.xlsx --- 工作表: Sheet1 --- 行 1: 列 1: 姓名 | 列 2: 年龄 | 列 3: 城市 | 行 2: 列 1: 张三 | 列 2: 30 | 列 3: 北京 | 行 3: 列 1: 李四 | 列 2: 25 | 列 3: 上海 | --- 工作表: Sheet2 --- 行 1: 列 1: 产品 | 列 2: 价格 | 列 3: 数量 | 行 2: 列 1: 铅笔 | 列 2: 2.5 | 列 3: 100 | 行 3: 列 1: 笔记本 | 列 2: 15 | 列 3: 50 |
5. 注意事项与最佳实践
- 错误处理：在打开文件、读取数据等操作中，务必进行错误处理。xlsx 包的许多函数都会返回 error，及时检查并处理这些错误是保证程序健壮性的关键。
- 单元格数据类型：cell.String() 方法会将单元格内容统一转换为字符串。如果需要处理数字、日期等特定类型的数据，可能需要根据业务逻辑进行额外的类型转换。xlsx 包也提供了 cell.Float()、cell.Int() 等方法来尝试获取特定类型的值。
- 大型文件处理：对于非常大的 Excel 文件，一次性加载所有数据可能会消耗大量内存。xlsx 包默认会将整个文件加载到内存中。如果遇到内存问题，可以考虑分块读取或寻找支持流式读取的库（尽管 xlsx 在一般情况下已足够高效）。
- 文件路径：确保提供的 Excel 文件路径是正确的。可以是相对路径（相对于程序执行目录）或绝对路径。
- 性能优化：在处理大量数据时，避免在循环内部进行不必要的计算或 I/O 操作。提前规划好数据结构，一次性读取所需数据，然后进行处理。
6. 总结
通过 github.com/tealeg/xlsx 包，Go 语言开发者可以方便高效地读取 Excel 文件中的数据。本教程从包的安装开始，详细介绍了打开文件、遍历工作表、行和单元格的完整流程，并提供了一个实用的代码示例。遵循本教程的指导和最佳实践，您将能够轻松地在 Go 应用程序中集成 Excel 文件处理功能。
