根本原因是Windows默认路径长度限制260字符，需先启用系统级长路径支持（注册表或组策略），再配置git config --system core.longpaths true，否则Git等工具仍不识别。
当你在 Windows 10 中克隆 Git 仓库、解压前端项目或打开 VS Code 工程时，遇到“Filename too long”报错、文件无法复制/删除/重命名，甚至 Node.js 编译失败，根本原因是系统对单行路径长度默认硬性限制在 260 字符以内，而现代代码工程（如 node_modules 嵌套、TypeScript 深层泛型路径、Webpack 输出目录）动辄突破 500+ 字符。
启用系统级长路径支持（永久生效）
这一步是所有后续操作的基础，不开启它，Git、PowerShell、VS Code 等工具仍会沿用旧路径解析逻辑。
方法一：注册表手动修改（全版本通用，含家庭版）
1. 按 Win+R 输入 regedit，回车后以管理员身份运行注册表编辑器。
2. 地址栏直接粘贴并跳转：HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem。
3. 在右侧空白处右键 → 新建 → DWORD (32 位) 值，命名为 LongPathsEnabled（若已存在则双击编辑）。
4. 将数值数据设为 1，基数选十进制即可。【必须重启电脑，否则任何应用都读不到该设置】
方法二：组策略启用（仅限专业版/企业版/教育版）
1. Win+R 输入 gpedit.msc 打开本地组策略编辑器。
2. 导航至：计算机配置 → 管理模板 → 系统 → 文件系统。
3. 双击“启用 Win32 长路径”，选择“已启用”，点击“确定”。
4. 同样需重启生效。若该项显示灰色且提示“此设置由更高优先级的策略禁用”，说明设备已加入域或被第三方安全软件锁定，此时请改用方法一。
让 Git 识别长路径（必须单独配置）
即使系统级长路径已开启，Git for Windows 默认仍使用旧式路径处理逻辑，必须显式启用其内部兼容开关。
第一步：打开 Git Bash 或 Windows Terminal（以管理员身份运行更稳妥）
第二步：执行命令：git config --system core.longpath true
第三步：验证是否生效，输入：git config --system core.longpath，返回 true 即成功。【注意：不要漏掉 --system 参数，否则只对当前用户生效，CI/CD 或其他账户下仍会报错】
快速清理已存在的超长路径文件（无需重启）
适用于刚解压完 node_modules 或误操作留下顽固文件夹，急需立刻清空又不想等重启的场景。
① 右键“开始”按钮 → 选择“Windows Terminal（管理员）”。
② 输入命令：Remove-Item -LiteralPath "D:\project\src\components\ui\form\validation\async\deep\nested\config\index.ts" -Force，把引号内路径替换成你实际要删的完整绝对路径（盘符必须有，反斜杠可用正斜杠替代，如 D:/project/... 更安全）。
③ 按 Enter 执行。若路径含 [ ]、{ } 或 *，【-LiteralPath 是唯一能正确识别它的参数】；漏掉它就会报“找不到路径”，哪怕你复制粘贴一字不差。
