最常用方式是Go 1.16+用os.ReadFile、旧版用ioutil.ReadFile,二者均一次性读入内存;大文件或需流式处理时用os.Open+bufio.Scanner;编码问题需手动处理,错误必须检查。

Go语言中读取文件内容最常用的方式是使用 ioutil.ReadFile(Go 1.16之前)或 os.ReadFile(Go 1.16+ 推荐),它们都是一次性将整个文件加载到内存并返回字节切片。下面介绍实际用法、注意事项及替代方案。
使用 os.ReadFile 读取文本文件(推荐,Go 1.16+)
os.ReadFile 是 ioutil.ReadFile 的替代函数,功能完全一致,但归属更清晰、标准库维护更统一。它自动处理打开、读取、关闭文件的全过程,简洁安全。
- 直接传入文件路径,返回
[]byte和error - 适合中小文件(如配置文件、JSON、日志片段等),不建议用于几百MB以上的大文件
- 读取后若需字符串,用
string(data)转换;若需结构化解析(如 JSON),可直接传给json.Unmarshal
示例:
data, err := os.ReadFile("config.json")if err != nil {
log.Fatal(err)
}
fmt.Println(string(data))
兼容旧版本:ioutil.ReadFile(Go
在 Go 1.15 或更早版本中,需导入 io/ioutil 包:
立即学习“go语言免费学习笔记(深入)”;
import "io/ioutil"用法与 os.ReadFile 完全相同:
if err != nil {
panic(err)
}
lines := strings.Split(string(data), "\n")
注意:Go 1.16 起该包已弃用,编译会提示警告,应尽快迁移到 os.ReadFile。
需要控制读取过程?用 os.Open + bufio.Scanner
当文件很大、或需逐行/按块处理(避免内存爆炸)、或要跳过某些内容时,不应一次性读入。此时推荐组合使用 os.Open 和 bufio.Scanner:
-
os.Open返回*os.File,记得用defer f.Close() -
bufio.Scanner默认按行扫描,高效且内存友好 - 支持自定义分隔符(如按空格、特定字符切分)
示例(逐行读取):
f, err := os.Open("large.log")if err != nil {
log.Fatal(err)
}
defer f.Close()
scanner := bufio.NewScanner(f)
for scanner.Scan() {
line := scanner.Text() // 不含换行符
fmt.Println(line)
}
if err := scanner.Err(); err != nil {
log.Fatal(err)
}
读取后如何正确处理编码和错误?
Go 原生只处理字节,不自动识别 UTF-8/BOM/GBK 等编码:
- 绝大多数 Go 项目默认使用 UTF-8,直接转
string(data)即可 - 若文件含 BOM(如 Windows 记事本保存的 UTF-8 with BOM),可用
bytes.TrimPrefix(data, []byte("\xef\xbb\xbf"))去除 - 遇到乱码且确认是 GBK/GB2312 编码,需借助第三方库如
golang.org/x/text/encoding转换 - 始终检查
err:路径不存在、权限不足、磁盘满等都会在此处暴露
常见错误处理写法:
data, err := os.ReadFile("input.txt")if errors.Is(err, os.ErrNotExist) {
log.Println("文件不存在")
return
} else if err != nil {
log.Printf("读取失败: %v", err)
return
}
不复杂但容易忽略:小文件用 os.ReadFile 最省心,大文件或流式处理选 os.Open + bufio,编码问题按需清理。保持错误检查习惯,能快速定位多数文件访问异常。










