如何使用Golang读取文件内容_使用ioutil ReadFile和os包访问文件

最常用方式是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.ReadFileioutil.ReadFile 的替代函数,功能完全一致,但归属更清晰、标准库维护更统一。它自动处理打开、读取、关闭文件的全过程,简洁安全。

  • 直接传入文件路径,返回 []byteerror
  • 适合中小文件(如配置文件、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 包:

import "io/ioutil"

用法与 os.ReadFile 完全相同:

data, err := ioutil.ReadFile("notes.txt")
if err != nil {
  panic(err)
}
lines := strings.Split(string(data), "\n")

注意:Go 1.16 起该包已弃用,编译会提示警告,应尽快迁移到 os.ReadFile

需要控制读取过程?用 os.Open + bufio.Scanner

当文件很大、或需逐行/按块处理(避免内存爆炸)、或要跳过某些内容时,不应一次性读入。此时推荐组合使用 os.Openbufio.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,编码问题按需清理。保持错误检查习惯,能快速定位多数文件访问异常。