最近想学习 DDD 架构，顺便克隆了一个有名的 DDD 框架开源项目 刚果商城（CongoMall） ，结果 git clone 时遇到了如下错误：

unable to create file
congomall-test-all/congomall-flow-monitor-agent-test/congomall-flow-monitor-message-provider-test/src/main/java/org/opengoofy/congomall/test/flowmonitor/agent/message/provide/rocketmq/FlowMonitorSpringCloudStreamRocketMQTest.java:
Filename too long
unable to checkout working tree
warning: Clone succeeded, but checkout failed.
You can inspect what was checked out with 'git status' and retry with 'git restore --source=HEAD :/'

大概意思是：Windows 文件路径过长 （默认 MAX_PATH = 260 ），导致 Git 无法创建对应文件。

我网上查了下解决办法，主要有几种，我用的是 方法 C （因为最简单，哈哈）。

#技术分享 #掘金解决方案

1. 启用 Windows 的长路径支持

Windows 10/11 可以通过组策略或注册表开启长路径。

方法 A：组策略

1. Win + R 输入 gpedit.msc 打开组策略编辑器。
2. 路径： 计算机配置 -> 管理模板 -> 系统 -> 文件系统 -> 启用 Win32 长路径 。
3. 将其设置为 启用 。
4. 重启电脑。

方法 B：注册表

如果你的 Windows 没有组策略（家庭版常见），可以用注册表：

reg add HKLMSYSTEMCurrentControlSetControlFileSystem /v LongPathsEnabled /t REG_DWORD /d 1 /f

然后重启电脑即可。

方法 C：Git 长路径支持（推荐）

直接让 Git 支持长路径：

git config --system core.longpaths true

2. 克隆到短路径目录

避免路径过长，比如：

cd C:git clone https://github.com/xxx/xxx.git c:
epo

3. 使用浅克隆（ --depth 1 ）

如果只想快速测试代码，不需要完整历史：

git clone --depth 1 https://github.com/xxx/xxx.git

4. Sparse Checkout（只下载指定目录）

只需要某些模块时可以这样：

git clone --no-checkout https://github.com/xxx/xxx.git
cd xxx
git sparse-checkout init --cone
git sparse-checkout set some/sub/path
git checkout

5. 如果仓库已部分克隆

可以重新签出：

git config core.longpaths true
git restore --source=HEAD :/

总结

最推荐的方式是直接执行：

git config --system core.longpaths true

或者把项目克隆到 路径较短 的目录（如 C: epo ）。