资料整理

Windows 提示路径过长：缩短目录和启用长路径并不是同一个修复

解压、Git 检出或安装节点时出现文件名过长，先找出失败的完整路径及执行程序。不要直接移动正在使用的虚拟环境，也不要只改注册表就认定所有程序都会支持长路径。

更新于 2026-09-26发布修订: 7资料基线: 7

现象与适用范围

检索片段；具体版本与异常上下文可能不同：

File name too long
WinError 206

Microsoft 的文件路径文档说明，部分 Windows 文件 API 的长路径行为需要系统配置和应用清单共同支持。LongPathsEnabled 不是对所有压缩软件、Python 扩展或旧程序统一生效的开关。 V04-WINPATH

1. 包尚未安装：下载目录、解压外层目录和节点子目录叠加后过长。

2. 已有环境运行正常：只有新节点检出或构建目录超长，问题发生在某个工具而非整个站点。

3. 系统已启用长路径，但出错程序不支持相应行为；再次修改同一个值未必改变结果。

以下为本站编排的操作建议，不表示已定位你的具体环境。

1. 保存原始错误和完整路径，在分享记录中替换个人用户名。确认是下载、解压、Git 还是构建工具抛出的错误。

2. 对尚未投入使用的新安装，选择有写入权限的较短专用目录，再从经过核验的原始压缩包重新解压。不要覆盖旧环境。

3. 若仅有某次新检出、解压或构建失败，先在该工具支持的独立、可写短路径位置测试该操作，保留原本正常运行的安装。只有安装根目录本身必须改变时，才先备份工作流和配置，再按声明的依赖重建短路径环境，并通过受支持的外部模型目录复用权重。Python 虚拟环境通常不能直接搬迁。Python venv

4. 确需系统长路径支持时，由有权限的人按 Microsoft 文档核对系统策略及应用支持，重启受影响进程，再重新执行之前失败的单一步骤。

原来失败的那个长文件名能够被创建或检出，且环境可从新入口启动。只看目录出现，不足以证明所有文件已经完整解压。

路径过长与拒绝访问、磁盘满、文件损坏应分别处理。系统策略可能由单位管理；不要用提权运行所有节点来代替定位。

资料复核并独立审阅中文：2026-09-27。本站未执行安装、检出、GPU 推理或用户环境修复。

同样的现象可能来自不同原因。可以按顺序查看下面这些相关条目。

匿名统计，只记录“有/没有帮助”的计数，不记录账号、IP 地址或设备信息。

2026-09-27 复核 Microsoft 长路径启用条件及 Python venv 的不可直接搬迁说明，并独立审阅中文；未安装、检出、迁移环境或运行 GPU。