短目录能打开、深目录失败，怎样验证Windows长路径边界

同一文件短目录能打开、深目录失败，应计算完整路径并核对系统、应用声明与实际API的长路径支持。Windows新版本不等于所有应用自动支持长路径；打开、枚举、打包、第三方插件和导入器可能使用不同接口，某一步成功不能证明全流程都支持。

先确定文件与环境

本文只检查字符串长度和支持条件，不修改注册表或应用清单。附件包含两条合成路径，不实际创建长目录。Windows路径常涉及UTF-16代码单元，不能把Python字符个数直接当所有系统限制；单个文件名组件、相对路径和前缀也有独立条件，260并非所有文件操作统一阈值。

操作与判断

1. 记录失败的完全限定路径和具体动作，例如读取图片、解压成员或枚举文件夹。保留工具版本与错误原文；“文件丢失”可能是上游复制没完成，不一定就是长路径。

2. 使用脚本计算完整路径的UTF-16代码单元，包含安装根和所有子目录。文件名看着短而部署根很深仍可能触发旧接口限制，不能只量最后一级名称。

3. 把相同文件的测试副本放在明确短根和长根下，保持内容与程序版本一致。现场创建目录是独立测试步骤，应先确认范围；本文脚本不替你创建或移动客户目录。

4. 若短根通过长根失败，查目标API、应用longPathAware声明、系统配置和组件限制。按供应方支持方式处理，再复测导入、保存、复制和重新打开，不能只把系统某个开关打开就结束。

输入对照与结果边界

案例	输入性质	脚本输出
短根案例	合成字符串	低于旧MAX_PATH风险线
深根案例	合成字符串	达到旧接口风险范围
真实兼容	系统＋API＋应用	仍待实际操作验证

脚本实际计算两条字符串，得到不同风险标记。风险标记不是“该文件必失败”，因为某些API可支持扩展路径，而另一些行为仍有旧限制。附带条件JSON刻意保留未知项，提醒读者缺少应用声明时不能仅凭Windows版本填写通过。非BMP字符也可能占两个UTF-16代码单元。

下载并复核

短长路径字符串、分层支持条件、UTF-16长度检查、实际计算结果。

下载cases.json、support-conditions.json与verify.py。将现场路径作为文本输入副本进行只读计算，勿把路径插入拼接的Shell命令执行。对外发送时可保持长度结构并脱敏客户名称，但应保留真实内部证据，避免脱敏后长度改变又把数值当原结果。

已实际计算合成路径的UTF-16长度并验证风险标记。未创建长路径、未改系统策略、未测试目标API读写。

失败时怎样继续

缩短路径仍失败时，转查保留名、非法字符、权限、压缩包名称编码与文件占用。不要把所有路径加上特殊前缀后交付，因为宿主程序和Shell未必按同样方式处理。对深层压缩包，解压器通过也不表示内部软件能打开；不同动作的错误要分别记录。

交付规范可以约定一个经过目标链验证的目录深度与命名预算，但应写成项目条件而非全Windows统一标准。迁移前对导入和导出路径做清单检查，保留短根回退方案。软件升级后重测曾失败的真实路径，不用合成长度表冒充现场成功证据。

相关背景可看展厅更换供应商时，怎样核对工程文件能否继续维护，继续从远程运维专题查找相关流程；需要结合项目确认时可查看SoftAgent 部署能力。

一级出处

• 长路径支持取决于API、系统配置和应用声明；不能仅看系统版本。

来源核对日期：2026-10-24。来源支持所述机制；本文合成输入与本地计算只证明所列文件及算法，不代表目标软件或现场设备已验收。