Go 语言中遍历当前目录及其一级子目录下的所有文件（非递归）

本文介绍如何使用 go 标准库高效、安全地遍历指定目录（如 project/）下的所有直接子文件和一级子目录中的普通文件，跳过深层嵌套目录，避免 filepath.Walk 的无限递归陷阱，并提供可直接运行的示例代码与关键注意事项。

本文介绍如何使用 Go 标准库高效、安全地遍历指定目录（如 `project/`）下的所有**直接子文件**和**一级子目录中的普通文件**，跳过深层嵌套目录，避免 `filepath.Walk` 的无限递归陷阱，并提供可直接运行的示例代码与关键注意事项。

在 Go 开发中，常需批量读取项目目录下所有顶层文件及文档子目录（如 docs/）中的静态资源，但不深入二级子目录（例如 docs/assets/css/ 应被忽略）。此时若误用 filepath.Walk 配合手动递归，极易导致路径解析错误、重复遍历或 panic——正如问题中出现的“it be a Directory! lets traverse project 循环打印 20+ 次”，其根源在于：filepath.Walk 本身已实现全树遍历，而回调函数内又调用 filepath.Walk(file.Name(), …)，造成对相对路径（如 “project”）的反复重入，且未拼接父路径，最终陷入死循环。

正确做法是放弃递归思维，采用两层显式迭代：

1. 第一层：读取目标目录（如 “project/”）下的所有条目；
2. 第二层：对每个子目录，单独调用 ioutil.ReadDir（Go 1.16+ 推荐 os.ReadDir）读取其内容，并仅处理其中的常规文件（IsRegular()），跳过子目录内的子目录。

以下是完整、健壮的实现（兼容 Go 1.16+，使用 os.ReadDir 替代已弃用的 ioutil.ReadDir）：

package main  import (     "fmt"     "os"     "path/filepath" )  func main() {     // 指定要遍历的根目录（支持相对路径或绝对路径）     root := "project"      // 第一层：读取 root 目录下的所有条目     entries, err := os.ReadDir(root)     if err != nil {         fmt.printf("无法读取目录 %s: %vn", root, err)         return     }      for _, entry := range entries {         entryPath := filepath.Join(root, entry.Name())          if entry.IsDir() {             // 第二层：仅遍历该一级子目录下的文件（不递归！）             subEntries, err := os.ReadDir(entryPath)             if err != nil {                 fmt.Printf("无法读取子目录 %s: %vn", entryPath, err)                 continue // 跳过出错的子目录，继续处理其他项             }             for _, subEntry := range subEntries {                 if !subEntry.IsDir() { // 仅处理文件                     fullPath := filepath.Join(entryPath, subEntry.Name())                     fmt.Printf("文件（一级子目录内）: %sn", fullPath)                     // ✅ 此处可调用 os.ReadFile(fullPath) 进行后续处理                 }             }         } else {             // 处理根目录下的直接文件             fmt.Printf("文件（根目录内）: %sn", entryPath)             // ✅ 此处可调用 os.ReadFile(entryPath) 进行后续处理         }     } }

? 关键说明：

• 使用 filepath.Join() 拼接路径，确保跨平台兼容（自动处理 / 与 ）；
• os.ReadDir() 返回 fs.DirEntry 切片，比 os.Stat() 更轻量，且 IsDir() 方法无需额外系统调用；
• 对每个子目录单独 ReadDir，天然限制为最多两层深度，完全符合“只遍历第一级子目录”的需求；
• 错误处理采用 continue 而非 return，保障部分子目录失败不影响整体遍历。

⚠️ 重要注意事项：

• 勿混用 filepath.Walk 与手动递归：Walk 是深度优先全量遍历，自行调用 Walk 会导致路径爆炸与逻辑失控；
• 警惕相对路径陷阱：entry.Name() 仅为文件名，必须通过 filepath.Join(root, entry.Name()) 构建合法路径才能安全打开；
• Go 1.16+ 迁移建议：ioutil.ReadDir 已废弃，请统一使用 os.ReadDir；
• 大目录性能提示：若需高并发处理文件内容，可在 fmt.Printf 位置启动 goroutine，但注意控制并发数并加 sync.WaitGroup。

总结而言，面对“仅限两级”的目录遍历需求，应摒弃递归幻想，拥抱清晰的双层 for 循环结构——它更易理解、更易调试、更易维护，也真正契合 Go “简洁即强大”的设计哲学。