Git Clone命令长目标路径失效问题的解决方法咨询

这个问题我之前踩过坑！大概率是操作系统的路径长度限制在作祟，不同系统的处理方式不一样，给你整理几个实用的解决办法：

首先可以排查下是不是路径长度超标了：

• Windows 默认限制路径长度为260字符（Windows 10 1607版本及以后可解除限制）
• Linux/macOS 的路径限制宽松很多（比如ext4是4096字符，APFS是10240字符），但极端长路径也可能触发问题

你可以先手动数一下目标路径的字符数，或者用命令查看：

• Windows：在终端输入echo <moveToDirectory> | measure -character
• Linux/macOS：在终端输入echo -n "<moveToDirectory>" | wc -c

如果是Windows的路径长度问题，试试这几个方法：

• 启用长路径支持
  适用于Windows 10 1607+或Windows 11：

  1. 打开组策略编辑器（输入gpedit.msc）
  2. 导航到计算机配置 > 管理模板 > 系统 > 文件系统
  3. 找到并启用启用 Win32 长路径，重启终端后再尝试克隆

  或者通过注册表修改：

  1. 打开注册表编辑器（输入regedit）
  2. 定位到HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem
  3. 找到LongPathsEnabled（如果没有就新建DWORD值），将数值改为1，重启终端

• 使用短路径（8.3格式）
  用dir /x命令查看文件夹的短路径别名，比如C:\MyVeryLongProjectFolder会显示为C:\MYVER~1，然后用这个短路径作为moveToDirectory：

  git clone <repo_url> C:\MYVER~1\subfolder
  

• 先克隆到短路径再移动
  先把仓库克隆到一个短路径的临时文件夹，再用robocopy（专门处理长路径的工具）移动到目标位置：

  git clone <repo_url> C:\temp\myrepo
  robocopy C:\temp\myrepo <moveToDirectory> /E /COPYALL
  rmdir /S /Q C:\temp\myrepo
  

这类系统的路径限制很少触发，但如果遇到了：

• 用软链接简化路径
  先克隆到一个短路径，再在目标长路径位置创建软链接指向克隆的仓库：

  git clone <repo_url> /tmp/myrepo
  ln -s /tmp/myrepo /very/long/path/with/many/folders/myrepo
  

• 给路径加引号
  如果是终端解析长路径时出错，把目标路径用双引号括起来：

  git clone <repo_url> "/very/long/path/with spaces and nested folders"
  

• 简化目标路径结构
  如果可以的话，尽量减少文件夹层级，或者把过长的文件夹名改短，从根源避免路径长度问题。

• 先克隆.git文件夹再检出
  用--no-checkout选项先只克隆仓库的.git目录，再把它移动到目标长路径，最后执行检出：

  git clone --no-checkout <repo_url> temp_repo
  mv temp_repo/.git <moveToDirectory>
  rmdir temp_repo
  cd <moveToDirectory>
  git checkout
  

内容的提问来源于stack exchange，提问作者nitika