本文介绍如何在 go 中高效、安全地遍历指定目录下的所有文件，仅限当前目录及其直接子目录中的普通文件，跳过二级及更深嵌套路径，避免无限递归或路径错误。
本文介绍如何在 go 中高效、安全地遍历指定目录下的所有文件，**仅限当前目录及其直接子目录中的普通文件**，跳过二级及更深嵌套路径，避免无限递归或路径错误。
在 Go 项目中，常需批量读取文档、配置或静态资源文件，但并非所有场景都需要深度遍历整个目录树。例如，你可能只想处理 project/ 下的 root.html 和 docs/index.html，而忽略 docs/assets/style.css 这类嵌套路径——即严格限制为 “当前目录 + 一级子目录中的文件”（共两层深度，且子目录内不再递归）。
这与标准库 filepath.Walk 的默认行为（深度优先全量遍历）存在本质区别：Walk 会持续向下探索每一级子目录，若配合手动递归调用（如原代码中在回调里再次调用 filepath.Walk(file.Name(), traverse)），极易导致路径解析错误、重复访问根目录、甚至无限循环（正如原问题中反复打印 “it be a Directory! lets traverse project” 所示）。根本原因在于：file.Name() 返回的是条目名（basename），而非完整路径；在子目录中直接用它调用 Walk，会导致相对路径错乱（如在 docs/ 中调用 Walk(“index.html”, …) 将失败，而 Walk(“docs”, …) 又会重新进入 project/docs，形成循环）。
因此，正确做法是放弃混合使用 Walk 与手动递归，转而采用显式、可控的两层遍历逻辑：
- 使用 ioutil.ReadDir（Go 1.16+ 推荐改用 os.ReadDir）读取目标目录下所有条目；
- 对每个条目：
- 若为文件 → 直接处理；
- 若为目录 → 再次调用 ReadDir 读取其内容，并仅处理其中的普通文件（跳过其子目录）。
以下是完整、可运行的示例代码（兼容 Go 1.16+，已升级为 os.ReadDir）：
package main import ( "fmt" "os" "path/filepath" ) func main() { // 指定要遍历的根目录（如 "project/"） root := "project" // 第一层：读取根目录内容 entries, err := os.ReadDir(root) if err != nil { panic(fmt.Sprintf("无法读取根目录 %s: %v", root, err)) } for _, entry := range entries { fullPath := filepath.Join(root, entry.Name()) if entry.IsDir() { // 第二层：仅遍历该一级子目录下的文件（不递归） subEntries, err := os.ReadDir(fullPath) if err != nil { fmt.Printf("警告：跳过无法访问的子目录 %s: %vn", fullPath, err) continue } for _, subEntry := range subEntries { if !subEntry.IsDir() { // 仅处理文件，忽略子目录 filePath := filepath.Join(fullPath, subEntry.Name()) fmt.Printf("? 文件（子目录内）: %sn", filePath) // 此处可调用 os.ReadFile(filePath) 进行实际处理 } } } else { // 第一层的普通文件 fmt.Printf("? 文件（根目录）: %sn", fullPath) // 此处可调用 os.ReadFile(fullPath) 进行实际处理 } } }✅ 关键优势与注意事项：
- 路径安全：全程使用 filepath.Join 构造绝对/规范路径，杜绝 file.Name() 引发的相对路径歧义；
- 深度可控：逻辑清晰限定为两层，天然规避深层嵌套和循环风险；
- 错误隔离：单个子目录读取失败（如权限不足）仅触发警告并跳过，不影响整体流程；
- 性能友好：无冗余系统调用，比 filepath.Walk + 深度计数过滤更轻量；
- 现代实践：使用 os.ReadDir（返回 fs.DirEntry）替代已弃用的 ioutil.ReadDir，减少不必要的 Stat 调用。
? 进阶提示：若需支持符号链接处理、自定义排序或并发读取，可在循环内扩展逻辑；但核心原则不变——用明确的两层 ReadDir 替代隐式的递归 Walk，方能精准满足“仅当前目录 + 一级子目录文件”的业务需求。