首页/开发/Git 与协作速查/Windows 长路径支持
进阶与大仓实践69 条

Windows 长路径支持

Windows 默认路径长度限制会让深层目录检出失败;设置 core.longpaths=true(并确认系统长路径策略)可缓解,主要在嵌套依赖与子模块场景遇到。

Git 与协作速查开发更新于 2026-10-12
配置git config --global core.longpaths true
系统侧Windows 长路径策略(LongPathsEnabled)需开启
影响深层 node_modules、子模块嵌套目录最常触发

常用示例

常用示例
git config --global core.longpaths true
git --version
# 检出失败的典型报错:Filename too long
企业镜像或旧工具链可能不感知长路径,遇到混合环境时先在小目录验证。

易错点

  • 只设 Git 配置而未开系统策略时长路径仍会失败
  • 部分编辑器与打包工具自身不支持长路径,需一并升级或在浅目录构建

数据来源与参考

  • Git for Windows 文档/提示(core.longpaths)
  • Microsoft 文档:Windows 路径长度限制(MAX_PATH 与长路径策略)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌