Golang读取文本文件的几种方法

本文深入解析了 Go 语言中读取文本文件的三种核心场景与最佳实践：针对小到中等文件，推荐使用 Go 1.16+ 官方标准的 `os.ReadFile`（取代已弃用的 `ioutil.ReadFile`），简洁高效；面对大文件或需逐行处理（如日志分析、CSV 解析）时，则应采用 `bufio.Scanner` 流式读取，避免内存溢出；而当文件编码非 UTF-8（如 GBK、BIG5）时，需借助 `golang.org/x/text/encoding` 等库进行显式转码。内容兼顾版本兼容性、性能权衡与编码细节，帮你避开常见坑点，写出更健壮、可维护的文件读取代码。

Go 语言中读取文本文件最常用、最简单的方式是使用 ioutil.ReadFile（Go 1.16+ 已迁移至 os.ReadFile），它会一次性把整个文件内容加载进内存并返回字节切片，再转成字符串即可。

用 os.ReadFile 读取文本文件（推荐，Go 1.16+）

从 Go 1.16 开始，ioutil.ReadFile 被弃用，官方建议改用 os.ReadFile，功能完全一致，更轻量、无额外依赖。

• 函数签名：os.ReadFile(filename string) ([]byte, error)
• 读取后通常转为字符串：string(data)
• 适合小到中等大小的文本文件（如配置、日志片段、JSON、模板等）

示例：

兼容旧版本：ioutil.ReadFile（Go < 1.16）

若仍在使用 Go 1.15 或更早版本，可继续用 ioutil.ReadFile，需导入 io/ioutil 包（Go 1.16+ 该包已弃用，不推荐新项目使用）。

• 行为与 os.ReadFile 完全相同
• 注意：Go 1.16+ 编译会警告，升级后请替换为 os.ReadFile

按行读取大文件（避免内存溢出）

当文件很大（几十 MB 以上）或不确定大小时，不建议一次性读入内存。可用 bufio.Scanner 按行流式读取：

• 内存友好，适合日志分析、CSV 处理等场景
• 默认单行上限 64KB，可通过 scanner.Buffer 调整
• 遇到空行或特殊分隔符时，也可自定义分隔符

示例（逐行打印）：

读取时指定编码（如 UTF-8 BOM、GBK 等）

Go 原生只支持 UTF-8（含带 BOM 的 UTF-8）。如果文件是 GBK、BIG5 等编码，需借助第三方库（如 golang.org/x/text/encoding）先解码：

• UTF-8 BOM 可用 bytes.TrimPrefix(data, []byte("\xef\xbb\xbf")) 清除
• GBK 文件示例：用 encoding.RegisterEncoding() + transform.NewReader 解码后再读
• 多数 Web 和 CLI 场景默认 UTF-8，无需额外处理

基本上就这些。小文件用 os.ReadFile 最省心；大文件或需逐行处理时上 bufio.Scanner；非 UTF-8 编码才考虑转码。不复杂但容易忽略版本差异和编码细节。

本篇关于《Golang读取文本文件的几种方法》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于Golang的相关知识，请关注golang学习网公众号！