应改用 os.readdir 手动递归替代 filepath.walk，因其返回 fs.direntry 不强制解码文件名；对 entry.name() 用 utf8.validstring() 校验，无效则跳过；windows 下需原始字节名时须用 syscall 或 x/sys/windows。
用 filepath.Walk 遍历文件时，中文路径报错 "invalid UTF-8"
Go 默认把文件系统路径当 byte 序列处理，某些系统（比如 Windows 上用 GBK 编码保存的旧目录）或挂载的网络盘可能含非法 UTF-8 字节，filepath.Walk 会直接 panic 或静默跳过。
实际做法不是“修复编码”，而是绕过解码：改用 os.ReadDir + 手动递归，它返回 fs.DirEntry，不强制解析文件名字符串。
- 避免用
filepath.Walk处理不可信来源的路径（如用户上传的压缩包解压目录） - 用
os.ReadDir获取子项后，对每个entry.Name()做utf8.ValidString()检查，无效则跳过或记录日志 - Windows 下若需保留原始字节名（比如要还原 GBK 文件名），得用
syscall或第三方库如golang.org/x/sys/windows，标准库不支持
替换文件名里的特殊字符，该用 strings.Map 还是正则 regexp.ReplaceAllString？
strings.Map 更快、更安全，尤其处理大量小文件时；正则适合复杂规则（比如“保留首字母+数字，其余全转下划线”），但有编译开销和回溯风险。
常见错误是用正则匹配 /[^w.-]/ 却漏掉 Unicode 字母——Go 的 w 默认只认 ASCII，中文、日文字符会被误删。
立即学习“go语言免费学习笔记（深入）”；
- 简单清洗（如只留字母数字和
-._）：用strings.Map配合unicode.IsLetter、unicode.IsDigit等判断 - 必须用正则时，写成
[^p{L}p{N}.\-_]，其中p{L}匹配所有 Unicode 字母 - 别在循环里重复
regexp.Compile，提前提前编译好复用
重命名文件时出现 "invalid cross-device link"
这是 Linux/macOS 常见错误：源路径和目标路径不在同一文件系统（比如从 /home 移到 /mnt/usb），os.Rename 底层调用 rename(2) 不支持跨设备。
不能靠 try-catch 切换逻辑，得提前判断。
- 用
os.Stat获取源/目标路径的sys.Stat_t.Dev（需import "syscall"），比较是否相等 - 不等就改用 “读取 + 写入 + 删除” 流程，注意权限继承（
os.Chmod）和时间戳保留（os.Chtimes） - Windows 上基本不会触发此错，但要注意
os.Rename对正在使用的文件会失败，得加重试或提示
批量处理时如何避免“重名覆盖”和“文件锁冲突”
两个问题常一起发生：比如把 report(1).txt 和 report(2).txt 都重命名为 report.txt，后者会覆盖前者；或者多个 goroutine 同时操作同一目录，os.ReadDir 和 os.Rename 无事务性，状态容易错乱。
- 生成新名前，先用
os.Stat检查目标路径是否存在；存在则加序号（如report_1.txt），而不是直接覆盖 - 不要用 goroutine 并发重命名同一目录下的文件——
os.Rename不是原子操作，且部分文件系统（如 ext4）对目录修改有缓存延迟 - 真要提速，按目录分组，每组起一个 goroutine，组内串行处理；或者用
sync.Mutex锁住重命名逻辑（粒度比整个函数小就行）
最麻烦的其实是符号链接和硬链接：它们会让 os.Stat 返回的 IsDir() 或大小信息失真，批量前最好先用 os.Lstat 明确区分。
