最常用方式是Go 1.16+用os.ReadFile、旧版用ioutil.ReadFile,二者均一次性读入内存;大文件或需流式处理时用os.Open+bufio.Scanner;编码问题需手动处理,错误必须检查。
Go语言中读取文件内容最常用的方式是使用 ioutil.ReadFile(Go 1.16之前)或 os.ReadFile(Go 1.16+ 推荐),它们都是一次性将整个文件加载到内存并返回字节切片。下面介绍实际用法、注意事项及替代方案。
os.ReadFile 是 ioutil.ReadFile 的替代函数,功能完全一致,但归属更清晰、标准库维护更统一。它自动处理打开、读取、关闭文件的全过程,简洁安全。
[]byte 和 error
string(data) 转换;若需结构化解析(如 JSON),可直接传给 json.Unmarshal
示例:
data, err := os.ReadFile("config.json")在 Go 1.15 或更早版本中,需导入 io/ioutil 包:
用法与 os.ReadFile 完全相同:
注意:Go 1.16 起该包已弃用,编译会提示警告,应尽快迁移到 os.ReadFile。
当文件很大、或需逐行/按块处理(避免内存爆炸)、或
要跳过某些内容时,不应一次性读入。此时推荐组合使用 os.Open 和 bufio.Scanner:
os.Open 返回 *os.File,记得用 defer f.Close()
bufio.Scanner 默认按行扫描,高效且内存友好示例(逐行读取):
f, err := os.Open("large.log")Go 原生只处理字节,不自动识别 UTF-8/BOM/GBK 等编码:
string(data) 即可bytes.TrimPrefix(data, []byte("\xef\xbb\xbf")) 去除golang.org/x/text/encoding 转换err:路径不存在、权限不足、磁盘满等都会在此处暴露常见错误处理写法:
data, err := os.ReadFile("input.txt")不复杂但容易忽略:小文件用 os.ReadFile 最省心,大文件或流式处理选 os.Open + bufio,编码问题按需清理。保持错误检查习惯,能快速定位多数文件访问异常。