同一条 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 大概率是正常的,所以我不把它写成通用结论。
判断口径
- 先查开关,别背口诀。
LongPathsEnabled为 1 时,Node、cmd、PowerShell 都能过 260;为 0 时第一步就失败。结论取决于机器,不取决于 Windows 版本号。 - 每个工具有自己的开关。 系统开了不等于工具开了。git 看
core.longpaths,默认 false,跨过 260 就exit 128。 - 报错码不可靠。 这一轮我一次
ENAMETOOLONG都没见到------因为系统放行了,Node 根本不报错。所以不能靠"有没有抛ENAMETOOLONG"判断长路径问题;要看开关和具体工具的实测。 - 看见相对路径的报错,先算绝对路径。
Filename too long配一条看起来不长的相对路径,是最容易误判的组合。
踩坑清单
- Node 全绿就以为全绿。 现象:四个
fsAPI 都正常,误判"环境没问题";原因:Node 直接吃系统开关;处理:换工具(git、打包器、压缩工具)再验一遍。 git add默认不开长路径。 现象:exit 128+Filename too long;原因:core.longpaths默认 false;处理:git -c core.longpaths=true或仓库级配置。- 报错只显示相对路径。 现象:路径看着 200 出头却报太长;原因:git 拼的是绝对路径;处理:按工作区根目录补全再算长度。
- 删除比创建更容易卡。 现象:
fs.rmSync在本机ETIMEDOUT;原因:删除走了回收站封装;处理:rd /s /q,或先把长目录改名再删。 - 控制台代码页会骗人。 现象:
cmd输出在 Node 里是一串����,看着像失败;原因:控制台是 GBK,Node 按 UTF-8 收;处理:以退出码为准,别以乱码为准。
带得走的两句话
长路径不是"Windows 不行",是"这条链路上有一环没开"。 系统一层、工具一层,逐层确认,比记 260 这个数字有用。
同一台机器上,工具的结论可以完全相反。 所以"我这边能跑"从来不是证据------要么写清环境,要么把每个工具单独跑一遍。这一轮里,Node 的四个 API、cmd、PowerShell 全部通过,只有 git add 一个 exit 128,就足以让整条流水线停下来。