本文介绍如何在 Go 中高效遍历指定目录下的所有文件，仅限当前目录及其直接子目录中的文件（不递归进入二级及更深子目录），并提供简洁、健壮、无副作用的实现方案。
本文介绍如何在 go 中高效遍历指定目录下的所有文件，**仅限当前目录及其直接子目录中的文件**（不递归进入二级及更深子目录），并提供简洁、健壮、无副作用的实现方案。
在实际项目构建、静态资源扫描或文档批量处理等场景中，常需对目录结构进行有界遍历：例如只读取 project/ 下的 root.html，以及 project/docs/index.html，但忽略 project/docs/assets/style.css（因其位于二级子目录）。这种“最多深入一层”的需求，不适合使用 filepath.Walk —— 它是为全树遍历设计的，强行混入手动递归不仅逻辑冗余，还极易引发路径错误、无限循环或 panic（如原问题中反复打印 project 并快速失败）。
根本问题在于：filepath.Walk 已自动递归访问整个子树，而用户又在回调中调用 filepath.Walk(file.Name(), ...)，导致对同一目录（如 "project"）被重复、无终止地重入遍历，最终耗尽栈空间或触发 I/O 错误。
✅ 正确解法是 放弃递归思维，采用两层显式循环：
- 第一层：读取目标目录（如 "project/"）下的所有条目；
- 第二层：对其中每个子目录，单独调用 ioutil.ReadDir（Go 1.16+ 推荐用 os.ReadDir）读取其内容，并仅处理其中的常规文件。
以下是生产就绪的完整示例（兼容 Go 1.16+，使用 os.ReadDir 替代已弃用的 ioutil.ReadDir）：
package main
import (
"fmt"
"os"
"path/filepath"
)
func traverseTwoLevels(root string) error {
// 第一层：读取 root 目录下的所有条目（文件 + 一级子目录）
entries, err := os.ReadDir(root)
if err != nil {
return fmt.Errorf("failed to read root directory %q: %w", root, err)
}
for _, entry := range entries {
entryPath := filepath.Join(root, entry.Name())
if entry.IsDir() {
// 第二层：仅遍历该一级子目录下的内容，不递归
subEntries, err := os.ReadDir(entryPath)
if err != nil {
fmt.Printf("warning: skip subdirectory %q (read failed): %v\n", entry.Name(), err)
continue // 跳过无法访问的子目录，不中断整体流程
}
for _, subEntry := range subEntries {
if !subEntry.IsDir() { // 仅处理文件，跳过子目录中的子目录
fullPath := filepath.Join(entryPath, subEntry.Name())
fmt.Printf("file (in subdirectory): %s\n", fullPath)
// ✅ 此处可调用 os.ReadFile(fullPath) 进行实际内容处理
}
}
} else {
// 当前目录下的普通文件
fmt.Printf("file (in root): %s\n", entryPath)
// ✅ 此处可调用 os.ReadFile(entryPath) 进行实际内容处理
}
}
return nil
}
func main() {
if err := traverseTwoLevels("project"); err != nil {
fmt.Fprintf(os.Stderr, "error: %v\n", err)
os.Exit(1)
}
}? 关键注意事项与最佳实践：
- 路径拼接务必使用 filepath.Join：避免手动拼接 / 导致跨平台问题（Windows 使用 \）；
- 错误处理要分层：根目录读取失败应中止；子目录读取失败建议 warn + continue，保障整体鲁棒性；
- 明确过滤逻辑：entry.IsDir() 判断目录，!subEntry.IsDir() 确保只处理文件，天然规避深层嵌套；
- 性能友好：仅发起两次系统调用层级（readdir），无递归开销，内存占用恒定；
- Go 版本适配：示例使用 os.ReadDir（Go 1.16+），若需兼容旧版本，请替换为 ioutil.ReadDir（注意其返回 []os.FileInfo，需额外 os.Stat 检查类型）。
总结而言，面对“限定深度”的目录遍历需求，应摒弃“用 Walk + 手动递归”的反模式，转而采用清晰、可控的双层循环结构。它逻辑直白、易于测试、便于扩展（如增加文件后缀过滤、大小限制等），是 Go 生态中处理此类问题的标准实践。
