Windows 超长文件名解决方案

John_Hui2026-03-17 11:16

在 Windows 上克隆 gocryptfs 时遇到的错误是由于仓库中包含超长文件名（超过 Windows 默认路径长度限制 260 字符）的测试文件导致的。虽然这些文件仅用于测试，编译时并不需要，但 Git 在检出工作树时仍会尝试创建它们，从而导致失败。

方案一：启用 Git 长路径支持并重新克隆（推荐）

Windows 10 版本 1607 及之后支持长路径（超过 260 字符），但需要 Git 和系统同时启用。

以管理员身份打开 PowerShell，启用系统长路径支持（如果尚未启用）：
powershell 复制代码
```
New-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" -Name "LongPathsEnabled" -Value 1 -PropertyType DWORD -Force
```
修改注册表后需要重启计算机才能生效。
配置 Git 支持长路径（全局设置）：
powershell 复制代码
```
git config --global core.longpaths true
```
删除之前克隆失败的目录（如果存在）：
powershell 复制代码
```
Remove-Item -Recurse -Force D:\gocryptfs-build\gocryptfs
```
重新克隆仓库：
powershell 复制代码
```
git clone https://github.com/rfjakob/gocryptfs.git
cd gocryptfs
git checkout v2.6.0
```
此时 Git 应能正常检出所有文件（包括超长文件），编译即可继续。