在 Windows 系統中使用 Git 時，遇到 Filename too long 錯誤通常是由于系統默認的路徑長度限制（260 字符）導致的。以下是綜合多種場景的解決方案：
一、快速解決方法
- 啟用 Git 長路徑支持
通過 Git 配置命令允許處理超長文件名：
git config --system core.longpaths true
- 適用場景：全局生效，適用于所有倉庫[[1][3][7][9][11][13][14]。
- 注意：若使用
--system參數，需以管理員權限運行 Git Bash 或命令行。
- 僅針對當前倉庫配置
git config core.longpaths true
- 適用場景：僅當前倉庫生效，避免全局修改[[3][7][9]。
二、系統級解決方案（Windows 專業版/企業版）
-
啟用 Windows 長路徑支持
-
按
Win + R輸入gpedit.msc→ 進入 計算機配置 > 管理模板 > 系統 > 文件系統。 -
雙擊 啟用 Win32 長路徑 → 選擇 已啟用 → 保存[[10][14]。
-
修改注冊表（通用版）
-
按
Win + R輸入regedit→ 定位到：HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem -
修改
LongPathsEnabled的值為1→ 重啟系統生效[[10][14]。
三、其他場景的適配方案
- 縮短文件路徑
- 操作：將倉庫克隆到更短的根路徑（如
C:\git），避免多層嵌套目錄[[5][9][14]。 - 示例：
git clone https://github.com/xxx.git C:\git\project
- 重新克隆已存在的倉庫
若配置后仍報錯，可能是歷史緩存導致，需刪除原倉庫重新克隆：
rm -rf project # 刪除舊倉庫
git clone https://github.com/xxx.git # 重新克隆[[9][12]
- 使用管理員權限操作
- 場景：當 Git 操作涉及系統保護目錄（如
Program Files）時，需以管理員身份運行 Git[[1][10]。
四、注意事項
- Windows 家庭版限制：
家庭版無法通過組策略修改路徑限制，需通過注冊表或第三方工具（如微軟官方提供的長路徑補丁）[[10]。 - IDE 兼容性：
IntelliJ IDEA、VS 等工具可能需單獨配置 Git 路徑或重啟生效[[9][12]。 - 文件系統兼容性：
確保存儲倉庫的分區格式為 NTFS（FAT32 不支持長路徑）[[5][10]。
五、驗證是否生效
git config --get core.longpaths # 返回 true 表示配置成功
git status 或 git pull # 觀察是否仍報錯
通過以上方法可覆蓋 90% 的 Windows Git 長路徑問題，推薦優先嘗試 快速解決方法 或 系統級配置。更多細節可參考 。
)