如何用Golang使用io/ioutil读取文件内容_Golang ioutil文件读取实践

ioutil.ReadFile可用于读取小文件内容,返回字节切片需转字符串,适合旧项目维护;大文件可结合strings.NewReader和bufio.Scanner按行处理,但不推荐超大文件;Go 1.16+应使用os.ReadFile替代,功能一致且更符合现代实践。

在Go语言中,io/ioutil 包曾是读取文件内容的常用方式,虽然从 Go 1.16 开始已被标记为废弃(deprecated),但在维护旧项目或学习阶段仍会遇到。本文带你了解如何使用 ioutil 读取文件内容,并给出实际示例。

读取整个文件内容(ioutil.ReadFile)

最常用的函数是 ioutil.ReadFile,它可以一次性读取文件全部内容并返回字节切片。

示例代码:

package main

import (
    "fmt"
    "log"
    "io/ioutil"
)

func main() {
    content, err := ioutil.ReadFile("example.txt")
    if err != nil {
        log.Fatal(err)
    }
    fmt.Println(string(content))
}

说明:

  • 该方法适合小文件,因为它会将整个文件加载到内存中。
  • 返回的是 []byte,需用 string() 转换为字符串。
  • 如果文件不存在或权限不足,会返回错误。

按行读取大文件(配合 bufio)

虽然 ioutil.ReadFile适合大文件,但若你只想用 ioutil 读取部分内容,可以结合 strings.NewReaderbufio.Scanner 按行处理。

示例:

package main

import (
    "bufio"
    "fmt"
    "io"
    "io/ioutil"
    "strings"
)

func main() {
    content, err := ioutil.ReadFile("large.txt")
    if err != nil {
        panic(err)
    }

    reader := strings.NewReader(string(content))
    scanner := bufio.NewScanner(reader)

    for scanner.Scan() {
        fmt.Println(scanner.Text())
    }

    if err := scanner.Err(); err != nil && err != io.EOF {
        fmt.Fprintln(os.Stderr, "读取错误:", err)
    }
}

这种方式先用 ioutil 读入内存,再分段处理,仍不推荐用于超大文件。

替代方案:使用 os.ReadFile(Go 1.16+)

官方建议使用 os.ReadFile 替代 ioutil.ReadFile,功能完全一致,但属于标准路径。

示例:

content, err := os.ReadFile("example.txt")
if err != nil {
    log.Fatal(err)
}
fmt.Println(string(content))

导入包:"os",其他逻辑不变,更简洁且符合现代 Go 实践。

基本上就这些。ioutil 读文件简单直接,适合小项目或快速脚本,但要注意内存使用。新项目建议直接用 os.ReadFile