校验路径合法性需区分场景:完整路径用 Path.GetInvalidPathChars(),纯文件名用 Path.GetInvalidFileNameChars();须先用 Path.GetDirectoryName() 和 Path.GetFileName() 拆解再分别校验,且需额外检查保留名(如 CON)和路径结构有效性。

用 Path.GetInvalidPathChars() 和 Path.GetInvalidFileNameChars() 区分校验场景
路径合法 ≠ 文件名合法。Windows 下,C:oo:bar 整体是非法路径(冒号不允许),但 foo:bar 单独作为文件名片段时,冒号也非法;而 在路径中是分隔符,在文件名里直接出现就崩溃。所以得拆开校验:Path.GetInvalidPathChars() 用于检查完整路径字符串是否含非法字符(如 :、*、?、"、、<code>>、|),Path.GetInvalidFileNameChars() 更严格,额外排除 /、、.(末尾)、空格(开头/结尾)等——它只管“文件名部分”,不处理路径结构。
常见错误是拿 GetInvalidFileNameChars() 去校验整个 C: emp est.txt,结果一碰到 就误报非法。正确做法:先用 Path.GetDirectoryName() 和 Path.GetFileName() 拆解,再分别校验。
- 校验路径字符串(含盘符、目录)→ 用
Path.GetInvalidPathChars() - 校验纯文件名(不含路径)→ 用
Path.GetInvalidFileNameChars() - 注意:
GetInvalidFileNameChars()不检查保留名(如CON、AUX),需额外判断
手动遍历检查比 Path.IsPathRooted() 更可靠
Path.IsPathRooted() 只判断是否“看起来像根路径”(如以 C: 或 \ 开头),完全不校验字符合法性。比如 C:oo<bar> 是根路径,但含非法字符 <code>,直接传给 <code>File.Create() 会抛 ArgumentException。
真正安全的做法是:对路径字符串逐字符比对 Path.GetInvalidPathChars() 返回的数组。别依赖异常驱动——提前拦住比捕获 IOException 更可控。
- 不要用
try/catch包裹File.Exists()来“试探”路径是否合法 -
Path.IsPathRooted()和Path.HasExtension()都不校验字符,只是语法解析 - 网络路径(
\servershare)需额外检查 UNC 前缀是否规范,Path.GetInvalidPathChars()已覆盖其中非法字符
保留名(CON、PRN 等)必须单独处理
Windows 禁止使用 CON、PRN、AUX、NUL 及带数字后缀的变体(如 CON1、PRN99)作为文件名,哪怕字符全合法。这个规则 Path.GetInvalidFileNameChars() 完全不覆盖。
判断逻辑很简单:取 Path.GetFileNameWithoutExtension() 的前 3 个字符(忽略大小写),看是否匹配保留名列表;还要注意扩展名不影响判定——CON.txt 和 CON 一样非法。
- 保留名匹配不区分大小写:
con、Con、CON全部拦截 - 仅检查主文件名部分,不包括路径和扩展名
- 扩展名本身可以是
con(如file.con合法),但主名不能是保留名
实际校验函数建议这样写
把路径拆解、字符检查、保留名判断三步串起来,封装成一个函数比零散调用更稳妥:
public static bool IsValidFileName(string fileName)
{
if (string.IsNullOrWhiteSpace(fileName)) return false;
var nameOnly = Path.GetFileName(fileName);
if (string.IsNullOrEmpty(nameOnly)) return false;
// 检查非法字符
if (nameOnly.IndexOfAny(Path.GetInvalidFileNameChars()) >= 0) return false;
// 检查保留名(忽略扩展名)
var baseName = Path.GetFileNameWithoutExtension(nameOnly);
if (baseName.Length == 0) return false;
var reserved = new[] { "CON", "PRN", "AUX", "NUL", "COM1", "COM2", "COM3", "COM4", "COM5", "COM6", "COM7", "COM8", "COM9", "LPT1", "LPT2", "LPT3", "LPT4", "LPT5", "LPT6", "LPT7", "LPT8", "LPT9" };
if (reserved.Contains(baseName.ToUpperInvariant())) return false;
return true;
}
注意:这个函数只校验“文件名部分”。如果要校验完整路径,还需额外用 Path.GetInvalidPathChars() 扫描整个字符串,并确保盘符存在、长度不超过 MAX_PATH(260 字符)——不过后者通常由系统 API 自动截断或报错,主动检查成本高,按需添加。
最易被忽略的是保留名和大小写无关性,以及 GetInvalidFileNameChars() 对 . 的处理:它允许中间的点(如 file.name.txt),但禁止开头、结尾或连续多个点(.hidden 合法,.. 或 file. 非法)。这些边界情况不跑真实文件操作很难暴露。










