本文介绍如何使用 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"）的反复重入，且未拼接父路径，最终陷入死循环。
正确做法是放弃递归思维，采用两层显式迭代：
- 第一层：读取目标目录（如 "project/"）下的所有条目；
- 第二层：对每个子目录，单独调用 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: %v\n", 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: %v\n", entryPath, err)
continue // 跳过出错的子目录，继续处理其他项
}
for _, subEntry := range subEntries {
if !subEntry.IsDir() { // 仅处理文件
fullPath := filepath.Join(entryPath, subEntry.Name())
fmt.Printf("文件（一级子目录内）: %s\n", fullPath)
// ✅ 此处可调用 os.ReadFile(fullPath) 进行后续处理
}
}
} else {
// 处理根目录下的直接文件
fmt.Printf("文件（根目录内）: %s\n", 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 “简洁即强大”的设计哲学。
