如何使用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.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 包：

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.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，编码问题按需清理。保持错误检查习惯，能快速定位多数文件访问异常。