Go 1.16+ 废弃 ioutil.ReadDir，改用 os.ReadDir（返回 fs.DirEntry，更轻量）或 filepath.WalkDir（递归遍历，避免冗余 Stat）。需按需调用 d.Info()，优先用 d.IsDir() 或 d.Type() 过滤。
Go 1.16+ 不再推荐用 ioutil.ReadDir
这个函数在 Go 1.16 被标记为 deprecated，实际从 Go 1.19 开始已彻底移除。如果你在新项目里还看到 ioutil.ReadDir，说明代码没升级或依赖了旧文档。它被 os.ReadDir 替代，后者返回 []fs.DirEntry，性能更好、内存更省，且不强制读取全部文件元数据（比如不自动调用 Stat()）。
os.ReadDir 基础遍历：只列名字，不递归
这是最常用场景——列出某目录下所有直接子项（不含子目录内容），且默认不排序（顺序依赖系统底层 readdir 行为）。若需稳定顺序，得手动 sort。
- 返回的是
fs.DirEntry，轻量；要获取完整os.FileInfo（如修改时间、大小），需显式调用.Info() - 不处理符号链接目标，
.Name()返回的是链接本身名，不是它指向的文件名 - 遇到权限错误（如子目录不可读）会直接 panic，需用
os.ReadDir+ 错误检查，或改用filepath.WalkDir
package main
import (
"fmt"
"os"
)
func main() {
entries, err := os.ReadDir(".")
if err != nil {
panic(err)
}
for _, entry := range entries {
fmt.Println(entry.Name())
}
}
递归遍历用 filepath.WalkDir，不是 filepath.Walk
Go 1.16 引入 filepath.WalkDir，替代老的 filepath.Walk。关键区别：WalkDir 传入的是 fs.DirEntry，避免对每个文件都做 Stat()，尤其在大目录中能显著减少系统调用开销。
-
回调函数签名是
func(path string, d fs.DirEntry, err error) error - 若想跳过某个子目录（比如
node_modules），在回调里 returnfilepath.SkipDir - 若某路径
Stat()失败（如权限不足），err非 nil，此时d可能为 nil，别直接调d.Info() - 注意：即使跳过目录，其自身路径仍会进入回调一次（
d有效），只是不继续遍历其子项
package main
import (
"fmt"
"io/fs"
"path/filepath"
)
func main() {
filepath.WalkDir(".", func(path string, d fs.DirEntry, err error) error {
if err != nil {
return nil // 忽略权限错误，继续
}
if d.IsDir() && d.Name() == "vendor" {
return filepath.SkipDir
}
fmt.Println(path)
return nil
})
}
需要文件大小/时间？谨慎调 d.Info()
fs.DirEntry.Info() 是按需触发系统调用的。如果遍历中只对普通文件需要大小，就别对每个 d 都调 Info()——先用 d.Type() 或 d.IsDir() 过滤，再查。
立即学习“go语言免费学习笔记（深入）”；
-
d.Type()可快速判断是否为目录、符号链接、设备文件等，无需Stat() -
d.Info()在 Windows 上可能比 Unix 更慢，因 NTFS 元数据组织方式不同 - 若你其实只需要文件名和是否为目录，完全不用
Info()，os.ReadDir就够了
常见误写：if !d.IsDir() { info, _ := d.Info(); fmt.Println(info.Size()) } ——这里即使 d 是目录，Info() 仍会被调用，浪费。
