如何在Golang中使用io/ioutil快速读取文件

从Go 1.16起，ioutil.ReadFile被os.ReadFile取代，后者更推荐用于读取小文件，用法相似但无需导入ioutil，注意处理错误并避免用于大文件以防内存过高。

在Go语言中，io/ioutil 包曾被广泛用于简化文件操作，包括快速读取文件内容。不过需要注意的是，从 Go 1.16 开始，ioutil 包已被弃用，其功能已合并到 io 和 os 包中。尽管如此，了解如何使用它仍有帮助，尤其是维护旧项目时。

使用 ioutil.ReadFile 读取整个文件

ioutil.ReadFile 是最常用的方法，能一次性读取文件全部内容并返回一个字节切片（[]byte），无需手动管理文件句柄。

示例代码：

package main
import (
"fmt"
"log"
"io/ioutil"  // 注意：Go 1.16+ 建议使用 os.ReadFile
)
func main() {
content, err := ioutil.ReadFile("example.txt")
if err != nil {
log.Fatal(err)
}
fmt.Println(string(content))
}

这段代码会读取当前目录下 example.txt 的全部内容，并将其转换为字符串打印出来。错误处理必不可少，特别是当文件不存在或权限不足时。

替代方案：使用 os.ReadFile（推荐）

由于 ioutil 已被弃用，官方推荐使用 os.ReadFile 实现相同功能，用法几乎一致，但更现代且持续支持。

立即学习“go语言免费学习笔记（深入）”；

小绿鲸英文文献阅读器

英文文献阅读器，专注提高SCI阅读效率

40

查看详情

更新后的写法：

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

这个方法同样自动打开、读取、关闭文件，极大简化了操作流程，适合读取小到中等大小的文件。

适用场景与注意事项

这类“一次性读取”方法适用于配置文件、日志片段或小文本处理。但要注意：

• 大文件可能导致内存占用过高，应改用流式读取（如 bufio.Scanner）
• 确保运行程序时有足够文件访问权限
• 路径可以是相对路径或绝对路径，注意跨平台兼容性

基本上就这些。虽然 ioutil.ReadFile 很方便，但现在优先选择 os.ReadFile 更符合 Go 的演进方向。不复杂但容易忽略版本变化带来的影响。