os.ReadDir是Go 1.16+推荐的轻量目录遍历函数，返回[]fs.DirEntry（仅含Name()、IsDir()、Info()），非已弃用的ioutil.ReadDir所返回的[]os.FileInfo；二者类型不兼容，不能直接替换，需按需调用entry.Info()获取完整元数据。
os.ReadDir 是什么，为什么不能直接替换 ioutil.ReadDir
os.ReadDir 和 ioutil.ReadDir 返回值类型不同：前者返回 []fs.DirEntry，后者返回 []os.FileInfo。这意味着你不能把 os.ReadDir 的结果直接塞进原来用 os.FileInfo 的逻辑里——比如调用 .Name() 或 .IsDir() 时会编译失败，因为 fs.DirEntry 没有这些方法。
根本原因是 fs.DirEntry 是轻量接口，只保证提供 Name()、IsDir() 和 Info() 三个方法；而 os.FileInfo 是完整结构体，含大小、修改时间等字段。多数场景其实只需要判断名字或是否为目录，DirEntry 更快、内存更省。
如何安全迁移：先用 DirEntry，需要 FileInfo 时再调 Info()
大多数目录遍历逻辑只关心文件名和类型（比如过滤 .go 文件或跳过子目录），这时直接用 DirEntry 即可：
entries, err := os.ReadDir("/path")
if err != nil {
log.Fatal(err)
}
for _, entry := range entries {
if !entry.IsDir() && strings.HasSuffix(entry.Name(), ".go") {
fmt.Println(entry.Name())
}
}
只有当你明确需要文件大小、修改时间等元信息时，才调用 entry.Info() ——但要注意这会触发一次系统调用，可能带来性能开销：
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
- 如果批量处理大量小文件，且只需名字/类型，别无脑调
Info() -
entry.Info()可能返回错误（如权限不足），需检查 - 同一
DirEntry多次调Info()不会缓存结果，每次都是新 syscall
常见错误：误以为 os.ReadDir 支持通配符或递归
os.ReadDir 就是纯读取单层目录，不支持 **、* 或 filepath.WalkDir 那样的自动递归。如果你原来用 ioutil.ReadDir 后自己写循环遍历子目录，现在得改用 filepath.WalkDir 或手动递归：
- 要递归且需控制遍历逻辑（比如跳过某些目录），用
filepath.WalkDir+fs.DirEntry - 要简单扁平列出所有文件（含子目录内容），别自己嵌套
os.ReadDir，容易栈溢出或漏错误处理 -
filepath.Glob也不能替代os.ReadDir，它只做路径匹配，不实际读目录内容
兼容性与版本注意点
os.ReadDir 自 Go 1.16 引入，ioutil.ReadDir 在 Go 1.16 被标记为 deprecated，Go 1.22+ 已彻底移除。如果你还在用旧版 Go，升级前先确认：
- 项目最低支持 Go 版本是否 ≥ 1.16
- 第三方依赖是否已适配（比如某些老版本
golang.org/x/tools可能仍引用ioutil） -
go mod tidy会帮你发现残留的ioutil导入，但不会自动替换调用
真正麻烦的是那些封装了 ioutil.ReadDir 并暴露 []os.FileInfo 的内部工具函数——它们得重写签名，否则调用方全得跟着改。
