如何在Golang中读取文件内容_使用ioutil ReadFile和os包操作文件

Go中读取文件推荐os.ReadFile(小文件)或os.Open配bufio.Scanner(大文件逐行)、io.Copy(流式复制);注意路径、权限、编码及内存安全。

在 Go 中读取文件内容最常用的方式是 ioutil.ReadFile(Go 1.16 起已移至 os.ReadFile)和 os.Open 配合 io.Read 系列函数。两者适用场景不同:前者适合小文件一次性读取,后者更灵活、内存友好,适合大文件或需要流式处理的场景。

使用 os.ReadFile 读取整个文件(推荐,简洁安全)

Go 1.16+ 官方推荐用 os.ReadFile 替代已弃用的 ioutil.ReadFile。它自动打开、读取、关闭文件,代码简短且不易出错。

  • 函数签名:os.ReadFile(filename string) ([]byte, error)
  • 返回原始字节切片,如需字符串可转为 string(data)
  • 内部已处理错误、资源释放,无需手动 close

示例:

func main() {
  data, err := os.ReadFile("config.txt")
  if err != nil {
    log.Fatal(err)
  }
  fmt.Println(string(data))
}

使用 os.Open + bufio.Scanner 逐行读取(适合文本日志、配置等)

当文件较大,或只需按行处理(如解析日志、CSV 行),避免一次性加载全部内容到内存,推荐用 os.Open 配合 bufio.Scanner

  • os.Open 返回 *os.File,需显式 defer f.Close()
  • bufio.Scanner 默认每行上限 64KB,超长行会报错;可通过 ScanBytesBufio.Reader 自定义
  • 适合人类可读文本,不适用于含空字节或二进制数据

示例:

func main() {
  f, err := os.Open("lines.txt")
  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)
  }
}

使用 os.Open + io.ReadFull / io.Copy 读取任意大小(精细控制)

需要完全掌控读取过程时(如分块上传、加密解密、网络传输中继),可用 os.Open 获取 io.Reader,再配合底层读取函数。

  • io.ReadFull:确保读满指定长度,适合固定结构二进制头解析
  • io.Copy:高效复制(内部用 32KB 缓冲区),适合写入另一文件或网络连接
  • 注意:Read 可能只读部分数据,需循环调用或用 io.ReadAll(类似 os.ReadFile

示例(复制文件):

src, _ := os.Open("input.bin")
dst, _ := os.Create("output.bin")
defer src.Close(); defer dst.Close()
io.Copy(dst, src) // 自动分块,高效安全

常见注意事项与避坑点

实际开发中容易忽略的关键细节:

  • 路径问题:相对路径基于运行目录(os.Getwd()),非源码所在目录;建议用 filepath.Join 拼接,避免硬编码 /\
  • 权限错误:Linux/macOS 下无读权限、Windows 下文件被占用都会导致 open xxx: permission denied
  • 编码无关:Go 原生只处理字节,UTF-8 文本可直接转 string;GBK/GB2312 等需用 golang.org/x/text/encoding 转换
  • 大文件 panic:用 os.ReadFile 读 GB 级文件易触发 OOM;务必改用流式读取

不复杂但容易忽略。