当前位置: 代码网 > 科技>操作系统>Windows > 轻松突破260字符限制! Win11启用长路径支持的教程

轻松突破260字符限制! Win11启用长路径支持的教程

2025年08月21日 Windows 我要评论
在 windows nt 中资源管理器和诸多传统的 windows api 都对路径长度有限制,这个限制是 260 个字符 (包括盘符、冒号、反斜杠和文件名等等),如果文件的整个路径超过 260 个字

在 windows nt 中资源管理器和诸多传统的 windows api 都对路径长度有限制,这个限制是 260 个字符 (包括盘符、冒号、反斜杠和文件名等等),如果文件的整个路径超过 260 个字符则在访问、复制、删除时都会提示路径太长或文件名太长的错误。

这种限制属于历史遗留问题,最初微软设置这个限制主要是用来兼容旧版文件系统例如 fat 以及兼容早期的 windows api,但在现代开发设计中文件夹层级非常深的情况也非常常见,例如 node.js 项目中的 mode_modules 文件夹层级就非常多。

在 windows 系统中,「路径长度限制」一直是个让人头疼的老大难问题。出于历史兼容性考量,win32 api 默认把「完整路径」限制在 260 个字符以内,这个长度由常量max_path来定义。

为了解决这个问题,并提升兼容性。从 windows 10 1607 开始,微软在 win32 api 中引入了「长路径支持」功能。启用后,用户和应用程序就可以使用最长约 32767 个字符的路径,大大提升了复杂文件目录结构的兼容性。

接下来,我们就来看看在 windows 11 中,如何为所有用户开启或关闭 win32 长路径支持。

windows 11 文件名和路径长度限制

1、微软官方文档怎么说

  • 文件名长度限制:在 ntfs 或 exfat 文件系统上,单个文件或文件夹名称(包括扩展名)的长度通常不超过 255 个字符。
  • 完整路径长度限制:默认情况下,包括 windows 11 在内,仍然遵循 max_path = 260 个字符的限制。所谓「完整路径」,就是指包括:盘符、冒号、反斜杠、所有目录与文件名,以及<nul>终止空字符的总长度。例如:
d:\主文件夹\我是一个子文件夹\我是一个孙子文件夹\我是一个重孙子文件夹\demo.txt

让我们来快速对比一下:

项目默认最大长度是否可扩展
单个文件(夹)名称~255 个字符
完整路径260 个字符(默认)✅ ~32767 个字符

2、超出限制会怎么样

微软文档只是理论值,实际测试结果可能有些玄幻,大致会出现以下几种情况:

  • 如果单个文件或文件夹名称超过限制,windows 11 会自动截断到最大长度。
  • 在文件夹嵌套时,如果「完整路径」超过上限,系统会直接拒绝创建。
  • 对于不同的文件类型,表现还不太相同。例如,在文件夹中新建超过(路径)长度限制的.txt文件时,名称可能会被截断,而不是直接报错。

指定的文件名无效或太长

目标路径太长

启用 win32 长路径支持

启用长路径支持后,就能打破max_path限制,让常用的 win32 文件和目录操作函数处理超过 260 个字符的路径。以后再遇到「套娃」式文件夹,也不用再担心操作失败。

1、通过「设置」

仅适用于 windows 11 25h2 及以高版本。

1、按windows + i快捷键打开「设置」,进入「系统」>「高级」。

2、在「文件资源管理器」区域中,打开「启用长路径」开关。

打开「启用长路径 」开关

2、通过组策略

如果你使用的是 windows 10 1607 及以上版本的专业版、教育版或企业版,可以更改组策略实现:

1、按windows + r快捷键打开「运行」对话框,输入gpedit.msc并回车,打开「本地组策略编辑器」。

2、依次展开「计算机配置」>「管理模板」>「系统」>「文件系统」。

3、将「启用 win32 长路径」策略,设置为「已启用」。

4、重启电脑让设置生效。

打开「启用 win32 长路径」组策略

3、通过注册表

1、按windows + r打开「运行」对话框,输入regedit并回车,打开注册表编辑器。

2、导航到以下位置:

hkey_local_machine\system\currentcontrolset\control\filesystem

3、找到名为longpathsenabled的 dword (32 位) 值(没有就新建),并将其十六进制值设置为:

  • 1:开启 win32 长路径支持(对所有用户生效)
  • 0:关闭 win32 长路径功能

4、重启电脑让设置生效。

指定 longpathsenabled 注册表值

注意事项

开启 win32 长路径支持后,并不意味着所有软件都能自动适配。只有在应用程序的程序清单(application manifest)中声明了longpathaware元素,明确表明支持长路径的应用,才能真正突破原有限制,充分利用这一特性。

(0)

相关文章:

版权声明:本文内容由互联网用户贡献,该文观点仅代表作者本人。本站仅提供信息存储服务,不拥有所有权,不承担相关法律责任。 如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 2386932994@qq.com 举报,一经查实将立刻删除。

发表评论

验证码:
Copyright © 2017-2025  代码网 保留所有权利. 粤ICP备2024248653号
站长QQ:2386932994 | 联系邮箱:2386932994@qq.com