应改用os.ReadDir手动递归替代filepath.Walk，因其返回fs.DirEntry不强制解码文件名；对entry.Name()用utf8.ValidString()校验，无效则跳过；Windows下需原始字节名时须用syscall或x/sys/windows。
filepath.Walk 会 panic 或静默跳过含非法 UTF-8 字节的路径，这不是编码问题，而是 Go 默认把路径当 UTF-8 字符串解析导致的；Windows 上用 GBK 保存的老目录、挂载的 SMB/CIFS 网络盘、用户上传解压的 zip 包，都可能触发。
别指望“修复路径编码”，得绕开字符串解码环节。
用 os.ReadDir 替代 filepath.Walk
这是最直接有效的切换：
-
os.ReadDir返回fs.DirEntry，其Name()方法只返回原始字节对应的字符串（不强制校验 UTF-8） - 你可以在拿到
entry.Name()后，用utf8.ValidString()主动检查：无效就跳过或记录日志，不 panic - 递归需手动实现（
os.ReadDir不递归），但逻辑清晰、可控性强 - Windows 下若需原始字节名（比如还原 GBK 文件名），标准库做不到，得用
golang.org/x/sys/windows或syscall
strings.Map vs regexp.ReplaceAllString 清洗文件名
简单替换优先用 strings.Map：
-
strings.Map是零分配、无正则引擎开销，适合批量小文件场景 - 判断逻辑写成
unicode.IsLetter+unicode.IsDigit+ 手动允许'.''-''_' - 用正则时，
w默认只认 ASCII，中文、日文会被误删；必须写成[^\p{L}\p{N}.\-_] - 正则编译有开销，别在循环里调
regexp.Compile，提前提前定义好全局变量复用
重命名时出现 invalid cross-device link
Linux/macOS 下跨文件系统移动文件会失败，os.Rename 底层调 rename(2) 不支持：
立即学习“go语言免费学习笔记（深入）”；
- 提前用
os.Stat拿到源和目标路径的sys.Stat_t.Dev，比较设备号是否一致 - 不一致就得走“读取 → 写入 → 删除”流程；注意保留权限（
os.Chmod）、时间戳（os.Chtimes） - Windows 基本不报这个错，但要注意正在被其他进程打开的文件，
os.Rename会直接失败，建议加重试或明确提示
写入非 UTF-8 编码文件（如 Windows-1252）
Go 字符串是 UTF-8，要写其他编码，必须转字节流：
- 用
golang.org/x/text/encoding，例如charmap.Windows1252 - 不要自己拼接字节；要用
encoding.Encoder.NewWriter(io.Writer)封装目标文件 - 写入时传 UTF-8 字符串，编码器自动转为目标编码字节
- 注意：错误处理不能只看
Write返回值，还要显式调encoder.Close()检查尾部错误（比如未完成的多字节序列）
os.ReadDir 不保证顺序，且多个 goroutine 并发操作同一目录时，os.Rename 和 os.Stat 都无原子性**——重名覆盖、文件锁冲突、状态竞态全靠你手动加锁或重试逻辑兜底。 
