最简递归方案是直接用Directory.GetFiles(path, ".", SearchOption.AllDirectories),无需手写递归;它原生支持、稳定高效,但大目录易OOM,此时应改用Directory.EnumerateFiles。

Directory.GetFiles 递归获取所有文件最简方案
直接用 Directory.GetFiles 加 SearchOption.AllDirectories 就能一次性拿到全部文件路径,不用手写递归。这是 .NET 2.0+ 原生支持的最稳妥方式,比自己写 foreach 遍历子目录更少出错。
- 默认只返回匹配的文件,不包含子目录路径
- 如果目标目录不存在,会抛出
DirectoryNotFoundException,需要提前检查或 try-catch - 路径中含中文、空格、特殊符号完全没问题,.NET 内部已处理编码
- 注意:若目录结构极深(比如上千层嵌套)或文件数量极大(百万级),可能触发内存压力或
PathTooLongException
示例:
string root = @"C:MyProject"; string[] files = Directory.GetFiles(root, "*.*", SearchOption.AllDirectories);
按扩展名筛选 + 排除某些目录的实用组合
真实项目里往往要过滤掉 bin、obj、.git 这类目录,而 Directory.GetFiles 本身不支持排除逻辑,得靠后续处理或换策略。
- 推荐先用
Directory.GetDirectories获取所有子目录路径,手动跳过黑名单目录,再对每个合法目录调用GetFiles - 避免用
string.Contains("bin")这种粗暴判断——C:in est.txt会被误杀;应比对Path.GetFileName(directory) - 如果只要
.cs和.json文件,把通配符换成"*.cs"和"*.json"分两次查,比用"*.*"后再Where筛选更快(底层是 Win32 FindFirstFile,模式匹配在系统层完成)
小技巧:用 new[] { ".cs", ".json" }.Select(ext => Directory.GetFiles(root, "*" + ext, SearchOption.AllDirectories)) 批量合并结果。
大目录遍历时内存爆掉?改用迭代式遍历
当文件总数超几十万,GetFiles 返回的 string[] 会一次性加载全部路径到内存,容易触发 GC 压力甚至 OutOfMemoryException。这时该切到流式处理。
- 用
Directory.EnumerateFiles替代GetFiles——它返回IEnumerable,按需枚举,内存占用恒定 - 注意:它不保证顺序,也不捕获中途的目录权限错误(遇到无权访问的子目录会直接跳过,不抛异常)
- 若需精确控制错误行为(比如记录哪些目录被拒绝),还是得用
Directory.GetDirectories+try/catch手动展开
示例:
foreach (string file in Directory.EnumerateFiles(root, "*.cs", SearchOption.AllDirectories))
{
// 处理单个文件,不会卡住或爆内存
}
跨平台路径分隔符和权限问题
在 Linux/macOS 上用 .NET Core/.NET 5+ 运行时,Directory.GetFiles 行为一致,但两个细节常被忽略:
- 路径字符串里的反斜杠
在 Unix 系统下不是分隔符,但 .NET 会自动转换,所以"C:\temp\*.log"在 Linux 上不会报错,只是查不到(因为没 C: 盘)——真正要改的是根路径逻辑,别硬编码盘符 - Linux 下遇到
UnauthorizedAccessException更频繁,尤其/proc或/sys下的虚拟路径,建议用try/catch包裹单次GetFiles调用,而不是整个递归块 - 用
Path.DirectorySeparatorChar拼路径虽安全,但GetFiles内部已兼容正反斜杠,日常开发中直接写"/home/user"或"C:\data"都可
真正麻烦的是符号链接循环引用——.NET 不检测软链闭环,可能无限遍历。生产环境务必确认目录不含自引用软链。











