Go 语言读取 Excel 文件方法详解

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 文件的基本步骤包括：

1. 导入必要的包：引入 xlsx 包以及标准库中的 fmt 和 log 包用于输出和错误处理。
2. 打开 Excel 文件：使用 xlsx.OpenFile() 函数打开指定的 .xlsx 文件。
3. 遍历工作表：Excel 文件可以包含多个工作表（Sheet），需要遍历这些工作表来访问其内容。
4. 遍历行：在每个工作表中，数据以行的形式组织，需要逐行遍历。
5. 遍历单元格：在每行中，数据存储在单元格（Cell）中，需要逐个访问单元格以提取其值。
6. 提取单元格值：单元格的值可以通过其提供的方法（如 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 文件处理功能。