同一条 294 字符的路径:Node 走得进去,git add 直接 exit 128

同一条 294 字符的路径:Node 走得进去,git add 直接 exit 128

先说结论

我在本机造了一条 294 字符的路径,然后用五个工具去碰它:

  • Node 的 fs.readdirSync / statSync / realpathSync / globSync:全部正常;
  • cmd /c dir、cmd /c type、PowerShell 的 Get-ChildItem(含 -Recurse):全部正常;
  • git add -A:exit 128,error: open("..."): Filename too long,fatal: updating files failed;
  • 加一句 -c core.longpaths=true:立刻成功。

也就是说,"Windows 路径不能超过 260 字符"这句话在我这台机器上已经不成立------真正决定能不能干活的是三样东西:系统开关、工具自己的开关、以及你用什么方式调用。

环境:Windows x64 / Node v22.22.2 / PowerShell 5.1.26100.9818 / git 默认配置。

路径是怎么长到 294 的

脚本逐级 fs.mkdirSync,每级目录名固定 24 字符(segNN_ 加 19 个 y):

js 复制代码
let cur = root;
for (let i = 1; i <= 9; i++) {
  const seg = 'seg' + String(i).padStart(2, '0') + '_' + 'y'.repeat(19); // 24 字符
  cur = path.join(cur, seg);
  fs.mkdirSync(cur);
}
fs.writeFileSync(path.join(cur, 'deep.txt'), 'payload');
text 复制代码
node v22.22.2 win32
deep dir len = 294

长度是算得出来的,不靠猜:根目录 60 字符,每级固定 1 个分隔符 + 25 字符目录名,九级一共 234,60 + 234 = 294。之所以把每级目录名钉死成 25 字符,是为了让"在第几级跨过 260"这件事可复现------用随机名测出来的长度,别人没法照着跑一遍。

在这之前我还跑过一轮更狠的:20 级、575 字符 ,全部 ok:

text 复制代码
level 18 ok  len=523
level 19 ok  len=549
level 20 ok  len=575

一级都没失败。所以问题不是"Node 建不出长路径",而是"某些工具进不去"。

为什么这台机器放行了

查一下系统开关:

powershell 复制代码
(Get-ItemProperty 'HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem' -Name LongPathsEnabled).LongPathsEnabled
text 复制代码
LongPathsEnabled = 1

1 就是放行。这个值是 Win10 1607 之后引入的,开了它,Win32 API 才允许超过 MAX_PATH(260)的路径。开了之后,Node 这类直接调 Win32 的工具就能一路往下走。

所以"260 字符"不是一条硬墙,而是一个默认关闭的开关 。同一条路径,在 LongPathsEnabled=0 的机器上,第一步 mkdirSync 就会失败------但我在这里测不到那个失败,因为我不会为了写一篇文章去改注册表。这点必须说清楚:本文所有"通过"的结论,前提都是本机这个开关为 1。

五个工具,同一条路径

同一个 cur,依次调用,真实结果:

工具 / 命令 结果
Node fs.readdirSync(cur) OK,entries= deep.txt
Node fs.statSync / fs.realpathSync OK,size=7 / len=294
Node fs.globSync('**/deep.txt',{cwd:root}) OK,count=1
cmd /c dir "<cur>" OK(输出是控制台代码页,Node 收下变乱码,属读法问题)
cmd /c type "<cur>\deep.txt" OK,payload
powershell Get-ChildItem -LiteralPath '<cur>' OK,deep.txt
powershell Get-ChildItem -Recurse -File OK,计数 1
git add -A(默认) FAIL exit=128
git -c core.longpaths=true add -A OK,git status --porcelain 1 行

唯一断掉的是 git。而且它断得很有代表性:报错里只有相对路径,看不到真实长度。

git 的原文报错

在一个新建仓库里,我把同样的九级目录放进工作区,然后 git add -A:

text 复制代码
error: open("g01_zzzzzzzzzzzzzzzzzzz/g02_zzzzzzzzzzzzzzzzzzz/g03_zzzzzzzzzzzzzzzzzzz/g04_zzzzzzzzzzzzzzzzzzz/g05_zzzzzzzzzzzzzzzzzzz/g06_zzzzzzzzzzzzzzzzzzz/g07_zzzzzzzzzzzzzzzzzzz/g08_zzzzzzzzzzzzzzzzzzz/f.txt"): Filename too long
fatal: updating files failed

exit=128,stderr 三行。注意它报的是仓库内的相对路径------按相对路径算是 200 出头,看起来"没超";真正超的是 git 打开文件时拼出来的绝对路径。这也是为什么这个错很难一眼看出来。

修法就一句:

bash 复制代码
git -c core.longpaths=true add -A

core.longpaths 默认是 false。开了之后 git 在 Windows 上会用 \\?\ 前缀去调 API,绕过 MAX_PATH。要持久化是 git config core.longpaths true(仓库级或 --global);我这一轮只验证了 -c 的单次形式,持久化写法属于常规配置,没有单独再跑一遍。

还有一点值得记:git 的开关和系统开关是两件事 。系统 LongPathsEnabled=1 之后,git 默认仍然是 false------它自己的开关不会因为你开了系统的就自动跟上。

删除环节,坑在别处

按流程该收拾现场了,fs.rmSync 直接失败:

text 复制代码
cleanup FAIL undefined [safe-delete] 操作失败: spawnSync F:\ai\WorkBuddy\resources\vendor\genie-trash\win32-x64.exe ETIMEDOUT

这不是 Windows 报的错,是我这台机器上装了删除拦截封装(走回收站那一套),它在超长目录树上超时了。换成命令行删除:

text 复制代码
[rd plain] OK, exists= false

cmd /c rd /s /q "<路径>" 三秒内删干净。这里我没有用 \\?\ 前缀------脚本里备了那条分支,但普通 rd 就已经过了。这条经验只对"装了删除封装的机器"有效,别的机器上 fs.rmSync 大概率是正常的,所以我不把它写成通用结论。

判断口径

  1. 先查开关,别背口诀。 LongPathsEnabled 为 1 时,Node、cmd、PowerShell 都能过 260;为 0 时第一步就失败。结论取决于机器,不取决于 Windows 版本号。
  2. 每个工具有自己的开关。 系统开了不等于工具开了。git 看 core.longpaths,默认 false,跨过 260 就 exit 128。
  3. 报错码不可靠。 这一轮我一次 ENAMETOOLONG 都没见到------因为系统放行了,Node 根本不报错。所以不能靠"有没有抛 ENAMETOOLONG"判断长路径问题;要看开关和具体工具的实测。
  4. 看见相对路径的报错,先算绝对路径。 Filename too long 配一条看起来不长的相对路径,是最容易误判的组合。

踩坑清单

  1. Node 全绿就以为全绿。 现象:四个 fs API 都正常,误判"环境没问题";原因:Node 直接吃系统开关;处理:换工具(git、打包器、压缩工具)再验一遍。
  2. git add 默认不开长路径。 现象:exit 128 + Filename too long;原因:core.longpaths 默认 false;处理:git -c core.longpaths=true 或仓库级配置。
  3. 报错只显示相对路径。 现象:路径看着 200 出头却报太长;原因:git 拼的是绝对路径;处理:按工作区根目录补全再算长度。
  4. 删除比创建更容易卡。 现象:fs.rmSync 在本机 ETIMEDOUT;原因:删除走了回收站封装;处理:rd /s /q,或先把长目录改名再删。
  5. 控制台代码页会骗人。 现象:cmd 输出在 Node 里是一串 ����,看着像失败;原因:控制台是 GBK,Node 按 UTF-8 收;处理:以退出码为准,别以乱码为准。

带得走的两句话

长路径不是"Windows 不行",是"这条链路上有一环没开"。 系统一层、工具一层,逐层确认,比记 260 这个数字有用。

同一台机器上,工具的结论可以完全相反。 所以"我这边能跑"从来不是证据------要么写清环境,要么把每个工具单独跑一遍。这一轮里,Node 的四个 API、cmd、PowerShell 全部通过,只有 git add 一个 exit 128,就足以让整条流水线停下来。

相关推荐
一条Go32 分钟前
探测规则:为什么它是告警规则的一种,而不是独立的任务体系
后端·架构·github
码事漫谈12 小时前
当公司不久后变成冒险者公会,我担心什么
后端
Csvn13 小时前
Nginx 负载均衡进阶与健康检查:哈希、keepalive 池与 DNS 自愈
后端·nginx
皮皮林55113 小时前
京东又开源一款新框架,用起来真优雅!
后端
学长毕设14 小时前
基于SpringBoot智慧养老服务平台设计与实现-附源码
java·spring boot·后端
一个游离的指针14 小时前
Vue2:vue-router
前端·javascript·vue.js
凌晨三点说晚安16 小时前
理解 JavaScript 对象、原型与包装类
javascript
行百里er16 小时前
【Spring Insight 技术分享】跨服务调用链路是怎么串起来的?
后端·spring·开源