0

0

C#解决“路径太长”异常 C#如何启用Win32长路径支持来操作文件

月夜之吻

月夜之吻

发布时间:2026-02-17 07:05:13

|

420人浏览过

|

来源于php中文网

原创

Windows默认限制路径长度260字符,超长即抛IOException;启用长路径需同时满足:系统为Win10 1607+/Server 2016+且注册表LongPathsEnabled=1,.NET项目正确配置EnableLongPaths或enforceFIPolicy。

c#解决“路径太长”异常 c#如何启用win32长路径支持来操作文件

为什么 System.IO 操作超长路径会直接抛异常

Windows 默认限制路径总长度不超过 260 字符(MAX_PATH),C# 的 File.CopyDirectory.GetFiles 等方法底层调用 Win32 API,一旦路径(含盘符、冒号、斜杠、文件名)超过这个限制,就会直接抛出 IOException,错误信息通常是“路径太长”或“The specified path, file name, or both are too long”。这不是 .NET 的 bug,而是系统级默认策略——即使你用 \? 前缀手动构造长路径,.NET Framework 4.6.2 及更早版本也会在内部做截断或校验失败。

启用长路径支持的两个必要条件缺一不可

仅靠修改注册表或代码加前缀都不够,必须同时满足:

  • 操作系统是 Windows 10 1607+ 或 Windows Server 2016+,且已启用组策略「启用 Win32 长路径」(对应注册表项 HKEY_LOCAL_MACHINESYSTEMCurrentControlSetControlFileSystemLongPathsEnabled 值为 1
  • .NET 应用需声明支持长路径:对 .NET Core 3.0+ / .NET 5+ 项目,在 .csproj 中添加 <enablelongpaths>true</enablelongpaths>;对 .NET Framework 4.6.2+,需在 app.config<runtime></runtime> 节点下添加 <enforcefipolicy enabled="false"></enforcefipolicy> 并确保目标平台 ≥ 4.6.2

漏掉任一环节,\?C: erylongpath... 这种形式仍会被拒绝或静默截断。

\? 前缀不是万能的,这些地方必须手动处理

\? 是 Win32 的长路径前缀,但 .NET 的很多高阶 API(如 Directory.EnumerateFilesPath.Combine)不会自动补上它,也不会识别已有前缀。常见陷阱包括:

  • Path.Combine(@"\?", "C:\a", "b") → 错误拼成 \?C:(多了一个 ),正确写法是 Path.GetFullPath(@"\?" + Path.Combine("C:\a", "b")) 或直接字符串拼接:@"\?" + fullPathWithoutPrefix
  • Directory.GetFiles(@"\?C:dir") 会成功,但 Directory.GetFiles(@"\?C:dir", "*.txt") 在某些旧版 .NET 中仍可能失败,建议改用 Directory.EnumerateFiles + 手动过滤
  • File.MoveFile.Copy 支持 \? 前缀,但源和目标都必须带前缀,且不能混用(比如源带前缀、目标不带)

推荐做法:封装一个长路径安全的文件操作辅助类

不要在业务逻辑里反复拼 ?,也不依赖用户手动开启所有配置。一个轻量封装能规避多数坑:

AI Time Machine
AI Time Machine

使用AI创建穿越历史的超逼真的头像

下载
public static class LongPathHelper
{
    public static string ToLongPath(string path) => 
        path.StartsWith(@"\?") ? path : @"\?" + Path.GetFullPath(path);
<pre class="brush:php;toolbar:false;">public static void CopyFile(string source, string dest, bool overwrite = false)
{
    File.Copy(ToLongPath(source), ToLongPath(dest), overwrite);
}

public static IEnumerable<string> EnumerateFiles(string path, string searchPattern = "*")
{
    return Directory.EnumerateFiles(ToLongPath(path), searchPattern);
}

}

注意:该类不解决递归遍历深层嵌套目录时的栈溢出问题,若路径层级极深(如 > 100 层),仍需考虑迭代式遍历或使用 FindFirstFileEx 等底层 API。

最易被忽略的一点:即使启用了长路径,NTFS 卷必须格式化为支持长路径的版本(现代 Windows 默认满足),而某些网络共享、OneDrive 同步文件夹或第三方虚拟文件系统可能根本不识别 \? 前缀——这时异常不会消失,只是换了个报错方式。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

553

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

216

2023.09.04

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

1553

2023.10.24

字符串介绍
字符串介绍

字符串是一种数据类型,它可以是任何文本,包括字母、数字、符号等。字符串可以由不同的字符组成,例如空格、标点符号、数字等。在编程中,字符串通常用引号括起来,如单引号、双引号或反引号。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

640

2023.11.24

java读取文件转成字符串的方法
java读取文件转成字符串的方法

Java8引入了新的文件I/O API,使用java.nio.file.Files类读取文件内容更加方便。对于较旧版本的Java,可以使用java.io.FileReader和java.io.BufferedReader来读取文件。在这些方法中,你需要将文件路径替换为你的实际文件路径,并且可能需要处理可能的IOException异常。想了解更多java的相关内容,可以阅读本专题下面的文章。

925

2024.03.22

php中定义字符串的方式
php中定义字符串的方式

php中定义字符串的方式:单引号;双引号;heredoc语法等等。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

876

2024.04.29

go语言字符串相关教程
go语言字符串相关教程

本专题整合了go语言字符串相关教程,阅读专题下面的文章了解更多详细内容。

185

2025.07.29

c++字符串相关教程
c++字符串相关教程

本专题整合了c++字符串相关教程,阅读专题下面的文章了解更多详细内容。

89

2025.08.07

pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法
pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法

本专题系统整理pixiv网页版官网入口及登录访问方式,涵盖官网登录页面直达路径、在线阅读入口及快速进入方法说明,帮助用户高效找到pixiv官方网站,实现便捷、安全的网页端浏览与账号登录体验。

283

2026.02.13

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
C# 教程
C# 教程

共94课时 | 9.6万人学习

C 教程
C 教程

共75课时 | 4.8万人学习

C++教程
C++教程

共115课时 | 18万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号