如何使用Golang读取文本文件内容_Golangioutil ReadFile文件读取方法说明

P粉602998670 2025-12-20 00:00:00 次阅读

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 main
import (
  "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+ 该包已弃用，不推荐新项目使用）。

行为与 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)
}