go语言无dir函数，目录操作依赖os和filepath包；推荐用os.mkdirall创建多级目录、filepath.walkdir（go 1.16+）替代walk实现安全高效遍历。
Go 语言没有 Dir 函数，别被名字误导
Go 标准库中根本不存在叫 Dir 的函数或类型——这是常见误解，可能源于其他语言（如 PHP 的 dir() 或 PowerShell 的 dir 命令）的迁移习惯。Go 处理目录的核心是 os 和 filepath 包，关键操作靠 os.Mkdir、os.MkdirAll、os.ReadDir（Go 1.16+）或 filepath.WalkDir 等组合完成。
创建单层/多层目录：用 os.Mkdir 还是 os.MkdirAll？
区别不在“是否递归”，而在“父目录不存在时的行为”：
-
os.Mkdir("a/b/c", 0755)：仅当a/b已存在时才成功；否则返回"no such file or directory"错误 -
os.MkdirAll("a/b/c", 0755)：自动逐级创建a→a/b→a/b/c，只要路径可写就成功 - 权限掩码（如
0755）在 Linux/macOS 生效，Windows 仅保留读/写标志，忽略执行位 - 若目录已存在，
MkdirAll不报错；Mkdir则返回*os.PathError，err.(*os.PathError).Err == syscall.EEXIST
安全遍历目录：为什么不用 filepath.Walk 而选 filepath.WalkDir？
filepath.WalkDir 是 Go 1.16 引入的替代方案，它比旧版 filepath.Walk 更可控、更不易 panic：
-
filepath.Walk内部调用os.Lstat+os.ReadDir，遇到符号链接循环或权限不足时容易触发不可恢复 panic -
filepath.WalkDir使用fs.DirEntry接口，只读取目录项元信息（不强制Lstat），支持提前中断（返回非 nil error 即停止） - 示例：跳过
.git目录
filepath.WalkDir(root, func(path string, d fs.DirEntry, err error) error {
if d.IsDir() && d.Name() == ".git" {
return filepath.SkipDir // 不进入该目录
}
if err != nil {
return err // 权限错误等直接终止
}
fmt.Println(path)
return nil
})
封装目录操作时最容易漏掉的三件事
自己写 DirUtils 类型或工具函数时，以下点常被忽略，导致线上行为异常：
- 路径分隔符硬编码：
"\"或"/"—— 必须用filepath.Join("a", "b", "c")或filepath.FromSlash()处理跨平台路径 - 未检查
os.IsNotExist(err)就直接创建目录 —— 比如想“确保目录存在”，却因拼写错误路径反复创建失败，又没判断错误类型，日志里全是重复的"no such file or directory" - 递归创建后没验证最终目录是否真有写权限 ——
MkdirAll成功只代表路径建出来了，但父目录可能是只读挂载点，后续os.Create仍会失败
目录操作的边界情况比想象中多，尤其在容器或 NFS 环境下，os.Stat 返回的 Mode().IsDir() 和实际可写性之间可能有延迟或权限错位。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
