C#遍历文件夹遇非法字符报错，无法列出含非法字符文件

我之前也碰到过一模一样的问题！.NET自带的Directory.GetFiles()和Directory.EnumerateFiles()确实有点“脆弱”——碰到包含非法字符的路径或者超长路径时，要么直接抛出异常跳过整个文件夹，要么遍历到报错的文件就直接停了，完全拿不到那些有问题的文件名。这本质是因为这些方法内部会先严格验证路径合法性，一旦发现不符合要求的内容就直接终止操作了。

下面给你几个实用的解决方案，按推荐程度排序：

1. 用.NET Core/.NET 5+的原生支持（最简单） #

从.NET Core 3.0开始，微软终于支持了长路径（超过260字符），还能通过配置绕过部分非法字符的检查：

• 第一步，在你的项目文件（.csproj）里加个配置，开启长路径支持：

<PropertyGroup>
  <EnableWindowsLongPath>true</EnableWindowsLongPath>
</PropertyGroup>

• 然后，在代码里给EnumerateFiles套两层try-catch：外层捕获文件夹级别的异常，内层逐个捕获单个文件的异常。这样哪怕某个文件有问题，也不会中断整个遍历，还能把有问题的文件名捞出来：

public static void ScanDirectory(string targetPath)
{
    try
    {
        // 遍历所有文件，包括子文件夹
        foreach (var filePath in Directory.EnumerateFiles(targetPath, "*", SearchOption.AllDirectories))
        {
            try
            {
                // 处理正常文件的信息（比如获取大小、创建时间等）
                Console.WriteLine($"✅ 有效文件: {filePath}");
            }
            catch (ArgumentException ex)
            {
                // 捕获单个文件的非法字符异常
                Console.WriteLine($"❌ 含非法字符的文件: {filePath} | 错误: {ex.Message}");
            }
            catch (PathTooLongException ex)
            {
                // 捕获超长路径异常
                Console.WriteLine($"❌ 路径过长的文件: {filePath} | 错误: {ex.Message}");
            }
        }
    }
    catch (DirectoryNotFoundException ex)
    {
        Console.WriteLine($"⚠️ 文件夹不存在: {targetPath} | 错误: {ex.Message}");
    }
}

注意：这种方法对系统级的非法字符（比如\ / : * ? " < > |）还是会抛出异常，但至少能捕获到具体的文件名，不会让整个遍历崩盘。

2. 直接调用Windows API（最彻底，兼容.NET Framework） #

如果你的项目还在用.NET Framework，或者需要完全捕获所有含非法字符的文件，那就直接绕开.NET的验证，调用Windows底层的FindFirstFile和FindNextFileAPI——这些API不会像.NET方法那样“挑剔”，能返回系统里存在的所有文件，包括那些.NET认为“非法”的。

给你写个可直接用的示例：

首先定义需要的API结构和方法：

using System;
using System.IO;
using System.Runtime.InteropServices;

public static class Win32FileScanner
{
    // 对应Windows API的文件数据结构
    [StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
    private struct WIN32_FIND_DATA
    {
        public uint dwFileAttributes;
        public System.Runtime.InteropServices.ComTypes.FILETIME ftCreationTime;
        public System.Runtime.InteropServices.ComTypes.FILETIME ftLastAccessTime;
        public System.Runtime.InteropServices.ComTypes.FILETIME ftLastWriteTime;
        public uint nFileSizeHigh;
        public uint nFileSizeLow;
        public uint dwReserved0;
        public uint dwReserved1;
        [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 260)]
        public string cFileName;
        [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 14)]
        public string cAlternateFileName;
    }

    // 导入Windows API方法
    [DllImport("kernel32.dll", CharSet = CharSet.Unicode, SetLastError = true)]
    private static extern IntPtr FindFirstFile(string lpFileName, out WIN32_FIND_DATA lpFindFileData);

    [DllImport("kernel32.dll", CharSet = CharSet.Unicode, SetLastError = true)]
    private static extern bool FindNextFile(IntPtr hFindFile, out WIN32_FIND_DATA lpFindFileData);

    [DllImport("kernel32.dll", SetLastError = true)]
    private static extern bool FindClose(IntPtr hFindFile);

    // 核心扫描方法
    public static void ScanDirectory(string rootPath)
    {
        string searchPattern = Path.Combine(rootPath, "*");
        IntPtr findHandle = FindFirstFile(searchPattern, out WIN32_FIND_DATA findData);

        if (findHandle == IntPtr.Zero)
        {
            int errorCode = Marshal.GetLastWin32Error();
            Console.WriteLine($"⚠️ 扫描文件夹失败: {rootPath} | 错误码: {errorCode}");
            return;
        }

        try
        {
            do
            {
                // 跳过当前目录和上级目录的占位符
                if (findData.cFileName == "." || findData.cFileName == "..")
                    continue;

                string fullPath = Path.Combine(rootPath, findData.cFileName);

                // 判断是文件夹还是文件
                if ((findData.dwFileAttributes & FileAttributes.Directory) != 0)
                {
                    // 递归扫描子文件夹
                    ScanDirectory(fullPath);
                    // 检查文件夹名称是否含非法字符
                    if (HasInvalidFileNameChars(findData.cFileName))
                    {
                        Console.WriteLine($"❌ 含非法字符的文件夹: {fullPath}");
                    }
                }
                else
                {
                    // 检查文件名称是否含非法字符
                    if (HasInvalidFileNameChars(findData.cFileName))
                    {
                        Console.WriteLine($"❌ 含非法字符的文件: {fullPath}");
                    }
                    else
                    {
                        Console.WriteLine($"✅ 有效文件: {fullPath}");
                    }
                }

            } while (FindNextFile(findHandle, out findData));
        }
        finally
        {
            // 记得关闭句柄，避免资源泄漏
            FindClose(findHandle);
        }
    }

    // 定义Windows文件名的非法字符集合
    private static readonly char[] InvalidFileNameChars = { '\\', '/', ':', '*', '?', '"', '<', '>', '|' };

    // 检查名称是否含非法字符
    private static bool HasInvalidFileNameChars(string name)
    {
        return name.IndexOfAny(InvalidFileNameChars) != -1;
    }
}

使用的时候直接调用就行：

Win32FileScanner.ScanDirectory(@"C:\Your\Target\Folder");

这种方法还支持超长路径——只要给路径加上\\?\前缀，比如\\?\C:\Very\Long\Path\That\Exceeds\260\Characters，就能正常遍历了。

3. 处理超长路径的小技巧 #

不管用哪种方法，碰到超过260字符的路径，都可以手动给路径加\\?\前缀，强制Windows使用长路径模式：

string originalLongPath = @"C:\Very\Long\Path\...";
string extendedPath = @"\\?\" + originalLongPath;
// 用extendedPath作为扫描路径即可

最后总结一下：

• 如果你用的是.NET Core/.NET 5+，优先选第一种方法，简单又省心；
• 要是需要兼容.NET Framework，或者必须捕获所有非法字符的文件，就用第二种Windows API的方案；
• 超长路径的问题，加个\\?\前缀基本都能解决。

内容的提问来源于stack exchange，提问作者traveller