ioutil 包被弃用的原因是其职责过多，现将功能拆分至 os 和 io 包以实现更清晰的职责划分。1. 读取文件可使用 os.readfile 替代 ioutil.readfile；2. 写入文件可用 os.writefile 替代 ioutil.writefile；3. 读取目录则用 os.readdir 替代 ioutil.readdir，且返回类型从 []os.fileinfo 改为更灵活的 []fs.direntry；4. 平滑过渡只需替换导入包和函数调用；5. fs.direntry 提供了更高效的目录项信息访问方式，如 type() 方法判断文件类型；6. 最佳实践包括正确错误处理、使用 defer 关闭资源、大文件采用流式处理以减少内存占用。这些调整使代码结构更合理、易于维护，并体现了单一职责原则的重要性。
ioutil 包的弃用，简单来说，就是因为它承担了太多职责，不够专注。现在，这些职责被更清晰地分配到了 os 和 io 包中，使得代码结构更合理，也更易于维护。
解决方案
ioutil 包曾经是我们读取文件、目录的常用工具，比如
ioutil.ReadFile、
ioutil.WriteFile、
ioutil.ReadDir等。但现在，这些功能被迁移到了 os 和 io 包。
-
读取文件: 原来的
ioutil.ReadFile(filename string) ([]byte, error)
现在可以使用os.ReadFile(filename string) ([]byte, error)
直接替代。 实际上os.ReadFile
就是ioutil.ReadFile
的别名，所以使用方法完全一样，只是包的位置变了。立即学习“go语言免费学习笔记（深入）”；
-
写入文件:
ioutil.WriteFile(filename string, data []byte, perm os.FileMode) error
对应的是os.WriteFile(filename string, data []byte, perm os.FileMode) error
，同样也是别名。
读取目录:
ioutil.ReadDir(dirname string) ([]fs.DirEntry, error)
现在被os.ReadDir(dirname string) ([]fs.DirEntry, error)
取代。返回类型也从[]os.FileInfo
变成了[]fs.DirEntry
，这是一个接口，提供了更灵活的文件信息访问方式。弃用带来的思考: 这种拆分并非毫无意义。将文件操作集中在
os
包，而流式读写放在io
包，更符合职责分离的原则。这也提醒我们，在设计自己的代码时，也要注意单一职责原则，避免“万能类”的出现。
如何平滑过渡到新的API
平滑过渡其实很简单，直接将
import "io/ioutil"替换为
import "os"和
import "io"，然后将代码中的
ioutil.ReadFile替换为
os.ReadFile，
ioutil.WriteFile替换为
os.WriteFile，
ioutil.ReadDir替换为
os.ReadDir即可。
当然，如果你的项目还在使用
ioutil.ReadAll，那么就需要使用
io.ReadAll来替代，这个函数的功能是将一个
io.Reader中的所有数据读取到内存中。例如：
package main
import (
"fmt"
"io"
"os"
"strings"
)
func main() {
r := strings.NewReader("Hello, World!")
data, err := io.ReadAll(r)
if err != nil {
fmt.Println("Error:", err)
os.Exit(1)
}
fmt.Println(string(data))
}
为什么 fs.DirEntry
比 os.FileInfo
更灵活？
fs.DirEntry是一个接口，而
os.FileInfo是一个接口。
fs.DirEntry允许你只获取目录项的基本信息，而不需要像
os.FileInfo那样获取所有信息。这在处理大型目录时，可以提高性能。 此外，
fs.DirEntry接口提供了
Type()方法，可以更方便地判断文件类型（例如，是否为目录、符号链接等）。
例如：
package main
import (
"fmt"
"os"
)
func main() {
entries, err := os.ReadDir(".")
if err != nil {
fmt.Println("Error:", err)
os.Exit(1)
}
for _, entry := range entries {
fmt.Printf("Name: %s, IsDir: %v\n", entry.Name(), entry.IsDir())
fileInfo, err := entry.Info() // 获取 os.FileInfo
if err != nil {
fmt.Println("Error getting file info:", err)
continue
}
fmt.Printf("Size: %d\n", fileInfo.Size())
}
}除了迁移到 os 和 io 包，还有其他最佳实践吗？
当然有。在使用
os包进行文件操作时，务必注意错误处理。例如，打开文件时，要检查
os.Open返回的错误；写入文件时，要检查
os.Write返回的错误。 此外，使用
defer file.Close()来确保文件在使用完毕后被正确关闭，避免资源泄露。
对于大文件，尽量避免一次性读取到内存中，而是使用
io.Reader和
io.Writer进行流式处理。这样可以减少内存占用，提高程序的性能。
package main
import (
"fmt"
"io"
"os"
)
func main() {
// 复制文件
src := "source.txt"
dst := "destination.txt"
source, err := os.Open(src)
if err != nil {
fmt.Println("Error opening source file:", err)
os.Exit(1)
}
defer source.Close()
destination, err := os.Create(dst)
if err != nil {
fmt.Println("Error creating destination file:", err)
os.Exit(1)
}
defer destination.Close()
bytesCopied, err := io.Copy(destination, source)
if err != nil {
fmt.Println("Error copying file:", err)
os.Exit(1)
}
fmt.Printf("Copied %d bytes from %s to %s\n", bytesCopied, src, dst)
}在这个例子中，
io.Copy函数会将
source文件中的数据流式地复制到
destination文件中，而不需要将整个文件读取到内存中。
