Go 1.16+ 推荐用 os.ReadFile 一次性读取小到中等文本文件;大文件应使用 bufio.Scanner 按行流式读取;非 UTF-8 编码需借助 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、模板等)
示例:
package mainimport (
"fmt"
"os"
)
func main() {
data, err := os.ReadFile("hello.txt")
if err != nil {
fmt.Println("读取失败:", err)
return
}
fmt.Println("文件内容:", string(data))
}
兼容旧版本:ioutil.ReadFile(Go
若仍在使用 Go 1.15 或更早版本,可继续用 ioutil.ReadFile,需导入 io/ioutil 包(Go 1.16+ 该包已弃用,不推荐新项目使用)。
立即学习“go语言免费学习笔记(深入)”;
- 行为与
os.ReadFile完全相同 - 注意:Go 1.16+ 编译会警告,升级后请替换为
os.ReadFile
按行读取大文件(避免内存溢出)
当文件很大(几十 MB 以上)或不确定大小时,不建议一次性读入内存。可用 bufio.Scanner 按行流式读取:
- 内存友好,适合日志分析、CSV 处理等场景
- 默认单行上限 64KB,可通过
scanner.Buffer调整 - 遇到空行或特殊分隔符时,也可自定义分隔符
示例(逐行打印):
scanner := bufio.NewScanner(file)for scanner.Scan() {
line := scanner.Text() // 不含换行符
fmt.Println(line)
}
if err := scanner.Err(); err != nil {
log.Fatal(err)
}
读取时指定编码(如 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 编码才考虑转码。不复杂但容易忽略版本差异和编码细节。










