Go语言 io/ioutil 包常用函数解析与代码示例

青禾

发布时间：2026-10-14| 7人浏览过

原创

本文全面解析 Go 语言中 io/ioutil 包的常用功能。通过实例演示了如何使用 ioutil 进行目录扫描、文件内容读取、流数据包装处理以及临时资源管理，提供可直接运行的代码范例和关键参数说明。

ioutil.ReadDir：安全遍历目录结构

io/ioutil 提供了 ReadDir(dirname string) ([]os.FileInfo, error) 方法用于读取指定路径下的所有文件和子目录。该函数返回一个 []os.FileInfo 切片，其中每个元素都包含文件的元信息接口。通过迭代该切片，可以轻松获取文件名、大小、权限和修改时间等信息。

import (
	"fmt"
	"io/ioutil"
)

func main() {
	dir_list, e := ioutil.ReadDir("D:/test")
	if e != nil {
		fmt.Println("读取目录失败:", e)
		return
	}
	for _, v := range dir_list {
		// 打印基本信息
		fmt.Printf("名称: %s\n", v.Name())
		fmt.Printf("权限: %v\n", v.Mode())
		fmt.Printf("大小: %d bytes\n", v.Size())
		fmt.Printf("最后修改时间: %v\n", v.ModTime())
		// 判断是否为目录
		if v.IsDir() {
			fmt.Printf("[目录] %s\n", v.Name())
		} else {
			fmt.Printf("[文件] %s\n", v.Name())
		}
	}
}

ioutil.ReadFile：便捷读取文件全量内容

当需要一次性将文件内容加载到内存时，ReadFile(filename string) ([]byte, error) 是最简单的方式。它会打开文件、读取全部内容并自动关闭文件句柄，最终返回字节切片 ([]byte) 和可能的错误对象。适合处理较小规模的配置文件或文本数据。

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

func main() {
	data, err := ioutil.ReadFile("D:/test/widua.go")
	if err != nil {
		fmt.Println("读取文件出错:", err)
		os.Exit(1)
	}
	// 将字节切片转换为字符串输出
	fmt.Println(string(data))
}

ioutil.ReadAll & NopCloser：灵活的数据流处理

All 方法接收实现 io.Reader 接口的对象作为输入（如网络请求体、字符串缓冲器等），并将其所有内容读出为字节切片。由于 Reader 不一定实现 io.Closer 接口，如果需要模拟带关闭功能的读取器，可以使用 NopCloser(r io.Reader) io.ReadCloser 进行包装。

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

func main() {
	// 构造一个只读字符串流
	reader := strings.NewReader("Hello World")
	
	// 使用 NopCloser 将其包装为 ReadCloser
	r := ioutil.NopCloser(reader)
	defer r.Close()
	
	// 读取全部数据
	data, _ := ioutil.ReadAll(r)
	fmt.Println(string(data))
}

第1步：TempDir 创建唯一临时文件夹

在进行中间数据处理或测试时，往往需要一个干净的沙盒环境。TempDir(dir, prefix string) (name string, err error) 会在指定父目录下生成一个由前缀加随机数字组成的唯一临时文件夹名称。使用后建议调用 os.RemoveAll 清理。

执行要点：

入口参数：dir 是上级目录路径，prefix 是新文件夹的前缀名。
返回值：新创建的绝对路径字符串，若创建失败则返回 error。
完成状态：磁盘上生成对应的新文件夹。

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

func main() {
	tempDirPath, err := ioutil.TempDir("D:/", "my_temp_")
	if err != nil {
		fmt.Println("创建临时目录失败")
		return
	}
	fmt.Println("已创建临时目录:", tempDirPath)
	
	// 实际使用中记得清理
	os.Remove(tempDirPath)
}

第2步：TempFile 创建并打开临时文件

如果不仅需要目录还需要直接写入的文件指针，可以使用 TempFile(dir, prefix string) (f *os.File, err error)。它会创建一个随机命名且以指定前缀开头的文件，并在当前工作目录下打开它（默认权限 0600），同时返回可操作的 *os.File 指针。

操作指南：

主要用途：适用于缓存日志、序列化中间结果等场景。
注意点：使用前需对文件指针进行 Write 或 WriteString 操作，用完务必 Close。

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

func main() {
	tmpFile, err := ioutil.TempFile("D:/", "tmpfile-")
	if err != nil {
		fmt.Println("创建临时文件失败")
		return
	}
	defer tmpFile.Close()
	
	// 写入测试数据
	tmpFile.WriteString("Test Content")
	
	// 重新打开并读取验证
	data, _ := ioutil.ReadFile(tmpFile.Name())
	fmt.Println(string(data))
	
	// 清理测试文件
	os.Remove(tmpFile.Name())
}