必须重启系统才能使LongPathsEnabled=1生效,否则Windows API仍按260字符限制处理;VSIX不可双击安装,应改用7-Zip解压或code命令行安装;扩展目录路径过长时需用mklink创建符号链接或--extensions-dir指定短路径。

改注册表不重启、用错启动方式、VSIX解压走资源管理器——这三件事凑一块,Node相关扩展必装失败。
LongPathsEnabled=1 但 VSCode 还报“文件名过长”
注册表改了只是第一步,LongPathsEnabled 值设为 1 后必须重启系统,否则部分 Windows API(尤其是 Shell 和 ZIP 解压路径)仍按 MAX_PATH=260 处理。VSCode 自身不校验该策略,它依赖底层系统行为。常见误操作包括:
- 只改注册表没重启,就直接双击桌面图标启动 VSCode
- 从 PowerShell 或 CMD 中执行
code命令,但该终端本身未继承长路径感知能力(旧版 Windows Terminal 或非管理员 Shell 可能不支持) - 用带空格或嵌套很深的批处理脚本调用
Code.exe,导致启动参数被截断或路径解析异常
验证是否真正生效:在管理员 PowerShell 中运行 New-Item -ItemType Directory -Path "C:$(\"x\"*250)\test" -Force,成功即表示系统层已通。
通过 SSH 隧道从 Android 设备在互联网上对 Windows PC 实现完整远程控制的设置与使用指南,适用于远程桌面访问、安全 RDP 等。
VSIX 安装失败:“指定文件名无效或太长”
VSIX 是 ZIP 包,但双击安装时 Windows 资源管理器会用传统 API 解压,哪怕注册表开了长路径也拦不住。此时不是 VSCode 的锅,是 Explorer 的限制。
- 别双击 VSIX 文件——右键 → 用
7-Zip→ “提取到当前目录”,再进文件夹拖入 VSCode 扩展面板 - 优先用命令行:
code --install-extension "D:\ext\my-ext.vsix",确保该路径本身(不含文件名)总长度 ≤240 字符 - 若必须移动 VSIX,用
robocopy带/256参数绕过路径限制:robocopy "C:\very\long\src" "D:\ext" "myext.vsix" /256
扩展安装目录路径太长引发连锁失败
VSCode 默认把扩展装在 %USERPROFILE%\.vscode\extensions,而 %USERPROFILE% 在域环境或 OneDrive 同步下常是 C:\Users\LongDomainName.LongFirstName\...,光前缀就超 150 字符,再加插件名和版本号极易突破临界点。
- 用符号链接重定向:先建短路径如
D:\vscode-ext,再执行mklink /J "%USERPROFILE%\.vscode\extensions" "D:\vscode-ext" - 启动时指定新路径更彻底:
code --extensions-dir "D:\vscode-ext",避免任何默认路径参与 - 不要手动修改
settings.json中的extensions.installDir—— 该配置已被弃用,VSCode 2.0+ 忽略它
真正卡住人的,从来不是“要不要开长路径”,而是注册表改了没重启、VSIX 拖进去了却用错命令行参数、或者以为改了 VSCode 设置就能解决底层路径限制——三者混在一起排查,最耗时间。

















