filepath.Walk是最稳妥的遍历起点，但需在回调中用info.IsDir()排除目录、strings.HasSuffix(strings.ToLower(info.Name()), ".pdf")过滤后缀、跳过隐藏文件和权限错误，并避免路径拼接错误与符号链接误判。
filepath.Walk 是最稳妥的起点，但仅靠它无法完成「按类型自动归类」——你得在遍历中识别文件、构造目标路径、处理重名和权限，最后 os.Rename 或 io.Copy 落地。整个流程容易卡在路径拼接错误、跨分区移动失败、中文文件名乱码或静默跳过符号链接上。
怎么用 filepath.Walk 安全遍历并过滤待整理文件
别直接对整个下载目录调用 Walk 后一股脑处理：它会进入 .DS_Store、Thumbs.db、临时锁文件甚至你刚解压一半的 .zip，导致误判或 panic。
- 在回调函数里先用
info.IsDir()排除目录，再用strings.HasSuffix(strings.ToLower(info.Name()), ".pdf")判断后缀（注意大小写） - 跳过隐藏文件：
strings.HasPrefix(info.Name(), ".") - 忽略正在被其他程序占用的文件：当
err != nil且os.IsPermission(err)或os.IsNotExist(err)时，返回nil继续；但若err是*os.PathError且含"text file busy"，建议跳过并记录日志 - 避免重复处理：可提前用
os.Stat检查目标分类目录是否存在同名文件，防止覆盖
怎么根据文件内容而非后缀判断真实类型
只看后缀不安全——用户可能把 shell.php.jpg 改名成 report.pdf 来绕过规则。Go 标准库的 net/http.DetectContentType 只读前 512 字节，对 PDF/ZIP/ELF 识别较准，但对图片（尤其是 WebP、AVIF）和支持 UTF-8 BOM 的文本识别不准。
- 对文档类（.pdf/.docx/.xlsx）优先用
filetype库：filetype.MatchReader能更可靠识别 Magic Number - 对文本类文件（log/json/md），用
io.ReadFull读前 4096 字节 +utf8.Valid校验是否为合法 UTF-8，再结合strings.Contains查关键字（如"{" 判 JSON、"# "判 Markdown） - 图片类必须加宽高校验：
image.DecodeConfig解析头信息，拒绝宽高 > 10000 的文件，防 DOS 攻击 - 不要在 Walk 回调里做耗时检测——把路径暂存到切片，遍历完再并发处理，避免阻塞整个 Walk 流程
怎么安全移动或复制文件到分类子目录
os.Rename 看似简洁，但它在 Linux/macOS 跨文件系统（比如从 /tmp 移到 /home）时会失败并返回 syscall.EXDEV；Windows 下则可能因权限或杀毒软件拦截静默失败。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
- 统一走
io.Copy+os.Remove：先os.Create目标路径，io.Copy(dst, src)写入，成功后再os.Remove源文件 - 目标路径必须用
filepath.Join拼接，并用filepath.Clean过滤../路径穿越（尤其当原始文件名来自用户输入或未清洗的元数据） - 分类目录需预先创建：
os.MkdirAll第二个参数设为0755，别用0644——目录没执行权限就进不去 - 移动后记得
os.Chmod修正目标文件权限，尤其从 NTFS 挂载卷拷过来的文件常丢失可执行位
怎么避免中文路径、空格和特殊字符导致失败
Go 运行时本身支持 UTF-8 路径，但问题常出在 shell 环境、终端显示或第三方工具链（如某些 FTP 客户端生成的文件名含 \r\n）。
- 所有路径打印调试时用
fmt.Printf("%q", path)，而不是fmt.Println(path)，能立刻暴露不可见字符 - 遇到
invalid argument错误，大概率是路径含控制字符，用strings.Map清洗：strings.Map(func(r rune) rune { if unicode.IsControl(r) || unicode.IsSpace(r) && r != ' ' { return -1 }; return r }, name) - Windows 下注意盘符大小写一致性：
F:\Download和f:\download在 Go 里是不同路径，但 Windows API 视为相同，易引发File exists错误 - 别依赖
os.Getwd()构造相对路径——启动目录可能不是项目根，改用os.Executable()+filepath.Dir定位二进制所在位置
实际跑起来时，最常被忽略的是符号链接的处理：filepath.Walk 默认不跟随，但如果你的下载目录里有软链指向外部硬盘，而你又想整理链目标里的文件，就得手动用 os.Readlink + os.Stat 判断并递归进入——这会让逻辑陡增复杂度，建议一开始就在配置里明确「是否跟随符号链接」开关。
