filepath.WalkDir比Walk更适合多级目录重命名，因其不默认跟随符号链接、可精确控制子目录进入逻辑、避免循环软链卡死；配合fs.DirEntry能安全判断文件类型、权限错误时返回SkipDir而非中断，并支持路径校验与原子重命名流程。
filepath.WalkDir 为什么比 filepath.Walk 更适合多级目录重命名
因为 filepath.Walk 遇到符号链接默认跟随，若目录里有循环软链或挂载点，可能卡死、遍历出意料之外的路径；而 filepath.WalkDir 提供 fs.DirEntry，能精确控制是否进入子目录，且不隐式读取子项内容。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 用
entry.Type().IsRegular()排除非普通文件（如目录、设备文件、套接字） - 对每个
DirEntry显式调用entry.IsDir()判断是否跳过——比如只处理当前层就直接return nil - 遇到
os.ErrPermission时返回filepath.SkipDir，而非nil或 panic，避免中断整个流程 - 别在遍历回调里直接调用
os.Rename：Windows 下可能因路径被占用或重命名后父目录结构变化导致后续遍历失败
重命名前必须做的三重路径校验
直接拼接新路径 + os.Rename 是高危操作，../evil.txt 这类名字不是假设，而是真实上传文件名中可能出现的片段。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 对每个原始文件名调用
filepath.Clean(oldPath)，再用strings.HasPrefix(cleaned, targetDir)确保没逃出目标根目录 - 拒绝含
..、\x00或控制字符（[\x00-\x08\x0b\x0c\x0e-\x1f]）的文件名，可用utf8.ValidString+ 正则快速过滤 - 调用
os.Stat(oldPath)确认源路径存在且是普通文件——防止把目录当文件重命名，也避免符号链接被误展开
跨文件系统重命名失败时怎么 fallback
os.Rename 在 Windows 上跨盘符（如 C:\ → D:\）、Linux/macOS 跨挂载点（如 /home 和 /mnt/usb）都会报 syscall.EXDEV 错误，此时必须手动 copy + remove。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 提前用
filepath.VolumeName(oldPath)和filepath.VolumeName(newPath)比较卷标（Windows）；Linux/macOS 用os.Stat获取dev字段比对更可靠 - fallback 时顺序必须是：
io.Copy→os.Chmod(new, info.Mode())→os.Chtimes(new, info.ModTime(), info.ModTime())→os.Remove(old) - 任一环节失败，保留已 copy 的
newPath并记录错误，**不要删它**——否则原文件已被删，新文件又不完整，就真丢了
如何避免重命名过程中的覆盖和状态不一致
批量操作没有“事务”，第 3 个文件失败时，前 2 个已改名，状态就不可逆。不能靠“全成功才提交”，而要单步原子 + 可逆。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 每步生成唯一临时名，如
fmt.Sprintf("%s.%d.tmp", base, time.Now().UnixNano())，先os.Rename(old, tmp)，再os.Rename(tmp, new) - 第二步失败时，
.tmp文件残留，可事后扫描清理；但至少源文件已安全移走，不会被覆盖 - 重命名前必须
os.Stat(newPath)：若存在且!overwrite，跳过或加序号后缀（如file_1.txt），而不是静默覆盖 - 所有路径拼接一律用
filepath.Join(dir, name)，别用dir + "/" + name—— Windows 下反斜杠、空格、Unicode 路径都可能崩
filepath.WalkDir 收集所有待处理文件路径到切片，再遍历切片执行重命名。否则一边遍历一边改名，某些系统会看到不一致的目录快照，尤其在并发或跨设备场景下，结果不可预测。 
