C# 文件系统API国际化 C#如何处理包含非英文字符的文件名和路径

windows 上 c# 文件操作原生支持中文路径，因 .net 直接调用 unicode 系统 api；常见错误多源于非法字符、路径超长、权限问题或归档编码不匹配，而非编码配置缺失。

Windows 上 C# File 和 Directory 操作默认就支持中文路径

只要系统区域设置是中文（或 UTF-8 兼容模式），File.copy、Directory.GetFiles 这类 API 天然能读写含中文、日文、emoji 的路径——不是“需要额外配置”，而是 .NET 从 2.0 起就依赖 Windows 的 Unicode API（CreateFileW 等）实现的。

常见错误现象：DirectoryNotFoundException 却确认路径存在；ArgumentException 提示“路径格式不正确”；文件名被截断或乱码显示。这些往往不是编码问题，而是路径本身不合法或权限/符号链接导致的。

• 检查路径是否含非法字符（ : " / | ? *），哪怕只是复制粘贴带入了全角符号
• 确认路径长度未超 260 字符限制（尤其在旧版 .NET Framework 下），可启用长路径支持（longPathAware=true in app.config 或组策略）
• 避免手动拼接路径：用 Path.Combine 替代 +，它会自动处理斜杠方向和空段

.NET 5+ 启用 UTF-8 文件系统编码需显式配置

linux/macos 下默认用 UTF-8，但 .NET 5+ 在 Windows 上仍默认走系统 ANSI 代码页（如 GBK），只有当路径经由 console.ReadLine() 或环境变量传入时，才可能因终端编码不一致出问题。

真正要干预的是跨平台部署场景：若程序在 Linux 容器中运行，且挂载了 Windows 主机上的 NTFS 卷（含中文文件名），而容器内 locale 是 C 或 C.UTF-8 不匹配，Directory.EnumerateFiles 就可能返回问号或空字符串。

• 启动前设置环境变量：export DOTNET_SYSTEM_GLOBALIZATION_INVARIANT=0（禁用 ICU 时必须关掉）
• 确保容器内 locale 支持 UTF-8：en_US.UTF-8 或 C.UTF-8，用 locale -a | grep UTF-8 验证
• 不要依赖 Encoding.default 处理文件名——它跟文件系统无关，只影响字符串到字节的转换

FileSystemInfo.Name 和 FullName 的编码行为完全一致

有人误以为 Name 是“原始字节解码”，FullName 是“转义后”，其实两者都直接返回 OS 返回的 Unicode 字符串。.NET 不做二次编码转换，所以不存在“用 Encoding.UTF8.GetBytes(name) 再还原”的必要。

容易踩的坑是把文件名当普通字符串做正则或截断：比如用 name.SubString(0, 10) 截中文，结果切在 UTF-16 代理对中间，后续显示异常；或用 Regex.Replace(name, @"[^w]", "_") 把中文全替成下划线。

• 取子串请用 string.Substring + StringInfo（按文本元素而非 char）
• 过滤非法字符时保留 Unicode 字母数字：char.IsLetterOrDigit(c) || char.IsPunctuation(c)，别硬套 ASCII 范围
• 日志打印路径前，先确认控制台编码：Console.OutputEncoding = Encoding.UTF8（Windows PowerShell 默认是 GBK）

第三方库如 SevenZipSharp 或 SharpCompress 可能破坏文件名编码

压缩包内文件名编码取决于打包工具写入时用的编码（如 winrar 默认用系统代码页，7-Zip 默认 UTF-8）。C# 解压库若没指定编码，会按 ZIP 规范 fallback 到 IBM437，导致中文变乱码。

这不是 .NET 文件系统 API 的问题，而是归档格式的历史包袱。你调 File.Move 没问题，但一解压就乱码，大概率卡在这儿。

• SharpCompress 解压时显式传 Encoding.UTF8：ReaderFactory.Open(stream, NULL, Encoding.UTF8)
• DotNetZip 已停止维护，且默认用 Encoding.Default，建议替换
• 生成 ZIP 时强制 UTF-8：用 ZipFile.SetUseUnicodeText(true)（ICSharpCode.SharpZipLib ≥ 1.3）

.NET 的文件系统 API 对国际化路径本身很老实，麻烦通常来自边界场景：跨平台挂载、归档格式兼容性、终端显示链路断裂。最该盯紧的不是“怎么开启 Unicode”，而是路径从哪来、到哪去、中间经过了几个编码层。