ioutil.ReadDir 已被弃用，因其功能移至 os.ReadDir；后者返回轻量级 fs.DirEntry 切片，仅含名称和类型标志，按需调用 .Info() 才加载完整元数据，提升性能。
为什么 ioutil.ReadDir 已被弃用，但你还可能看到它
Go 1.16 起，ioutil.ReadDir 已正式标记为 deprecated，它的功能已移入 os.ReadDir。如果你在旧项目、教程或报错信息里看到它，不是你写错了，而是代码没升级。继续用它不会立即报错，但会收到编译警告："ioutil.ReadDir is deprecated: Use os.ReadDir instead"。核心原因是 os.ReadDir 返回 []fs.DirEntry，比 ioutil.ReadDir 返回的 []os.FileInfo 更轻量——它默认不加载完整文件元数据（比如大小、修改时间），只读取名称和类型标志，按需调用 .Info() 才触发系统调用。
用 os.ReadDir 正确遍历目录（Go 1.16+）
这是当前标准做法。注意它返回的是 fs.DirEntry 切片，不是 os.FileInfo，所以不能直接访问 .Size() 或 .ModTime()。
package main
import (
"fmt"
"log"
"os"
)
func main() {
entries, err := os.ReadDir(".")
if err != nil {
log.Fatal(err)
}
for _, entry := range entries {
// entry.Name() 是文件/目录名（不含路径）
// entry.IsDir() 判断是否为目录
fmt.Printf("Name: %s, IsDir: %t\n", entry.Name(), entry.IsDir())
// 如果需要详细信息（如大小、时间），显式调用 Info()
// 注意：这会触发一次额外的系统调用
if !entry.IsDir() {
info, err := entry.Info()
if err == nil {
fmt.Printf(" Size: %d bytes\n", info.Size())
}
}
}
}
- 必须用
entry.Name()获取名称，不能用entry.Name（字段不存在） -
entry.IsDir()是廉价判断，推荐优先用它过滤目录，避免无谓的.Info()调用 - 如果只需要文件名列表，完全不用
.Info()，性能更好
如果必须兼容旧版 Go（
只能回退到 ioutil.ReadDir，但要注意它返回的是 []os.FileInfo，每个元素都已加载完整元数据，开销更大。
package main
import (
"fmt"
"io/ioutil" // Go < 1.16 才可用；1.16+ 需 import "io/ioutil" 并忽略警告
"log"
)
func main() {
infos, err := ioutil.ReadDir(".")
if err != nil {
log.Fatal(err)
}
for _, info := range infos {
fmt.Printf("Name: %s, IsDir: %t, Size: %d\n",
info.Name(), info.IsDir(), info.Size())
}
}
- Go 1.16+ 仍可编译，但会警告；Go 1.22+ 可能彻底移除该包（实际尚未移除，但风险存在）
- 所有
os.FileInfo字段（Size()、ModTime()、Mode()）可直接用，无需额外调用 - 若目录下有大量小文件，
ioutil.ReadDir的内存和系统调用开销明显高于os.ReadDir
常见错误：把 os.ReadDir 当成递归遍历工具
os.ReadDir 只做单层遍历，它不递归。很多人误以为“读取目录”就等于“列出所有子目录里的文件”，结果只看到第一层内容就停了。递归需要自己实现或改用 filepath.WalkDir（推荐）。
立即学习“go语言免费学习笔记（深入）”；
- 错误写法：
os.ReadDir("path/to/dir")→ 只得到path/to/dir下的直接子项 - 正确递归方案：用
filepath.WalkDir，它接收回调函数，自动处理嵌套层级 -
filepath.WalkDir的回调参数是fs.DirEntry，行为与os.ReadDir一致，同样支持按需.Info()
真正要遍历整个目录树时，别硬套 os.ReadDir 加递归逻辑，filepath.WalkDir 是更健壮、更少出错的选择。
