Golang目录遍历与文件操作教程

本文深入讲解了在 Go 语言中高效、安全地进行目录遍历与文件操作的核心实践：以标准库 `filepath.Walk` 为基石，结合 `WalkFunc` 实现智能过滤与轻量预处理，规避手动递归的风险；强调使用 `os.OpenFile` 和 `io.Copy` 替代已弃用的旧方法，确保读写可靠；同时贯穿跨平台意识，坚持用 `filepath.Join`、`filepath.Dir` 等函数处理路径，彻底解决 Windows/Linux 路径兼容问题——这些看似简单却极易踩坑的细节，正是写出健壮、可移植文件工具的关键所在。

用 filepath.Walk 遍历目录结构

Go 标准库的 filepath.Walk 是最常用、最稳妥的目录递归遍历方式。它自动处理符号链接、权限错误和路径拼接，比手动递归更安全。

基本用法是传入根路径和一个回调函数，每次访问到文件或子目录时都会调用该函数：

• 回调函数签名必须是 func(path string, info os.FileInfo, err error) error
• 可通过 info.IsDir() 判断当前项是否为目录；返回 filepath.SkipDir 可跳过该目录及其子项
• 遇到权限不足等非致命错误时，err 不为 nil，但 Walk 会继续遍历其他路径

例如统计所有 .go 文件数量，只需在回调中检查 strings.HasSuffix(info.Name(), ".go") && !info.IsDir() 即可。

安全读写文件：os.OpenFile 与 io.Copy

对文件进行增删改查，应避免直接用 os.Create 或 ioutil.WriteFile（后者在 Go 1.16+ 已弃用），推荐组合使用 os.OpenFile 和 io.Copy。

• os.OpenFile(path, flag, perm) 灵活控制打开模式：如 os.O_CREATE|os.O_WRONLY|os.O_TRUNC 表示覆盖写入，os.O_APPEND 表示追加
• 复制文件时，用 io.Copy(dst, src) 比手动读写 buffer 更简洁可靠；记得关闭源和目标文件句柄
• 删除前建议先用 os.Stat 检查是否存在，避免 panic；重命名（移动）用 os.Rename，它在同分区下是原子操作

按需过滤与分类：用 WalkFunc 做轻量预处理

实际工具中常需按扩展名、大小、修改时间等条件筛选文件。不建议在 Walk 后全量加载再过滤，而应在 WalkFunc 中边遍历边判断。

• 例如只处理最近 7 天修改的文件：用 time.Since(info.ModTime()) < 7*24*time.Hour
• 按扩展名分组：用 filepath.Ext(path) 提取后缀，维护 map[string][]string 记录各类型文件路径
• 跳过隐藏文件（以 . 开头）：检查 strings.HasPrefix(filepath.Base(path), ".")，满足则 continue

跨平台路径处理：始终用 filepath.Join 和 filepath.Dir

硬拼接路径字符串（如 "dir/" + name）在 Windows 下会出错。Go 的 filepath 包会根据运行系统自动使用 \ 或 / 分隔符。

• 拼接路径统一用 filepath.Join("root", "sub", "file.txt")
• 提取父目录用 filepath.Dir(path)，获取文件名用 filepath.Base(path)
• 标准化路径（消除 .. 和 .）用 filepath.Clean(path)，这对用户输入路径特别有用

不复杂但容易忽略

理论要掌握，实操不能落！以上关于《Golang目录遍历与文件操作教程》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！