使用Eclipse eGit克隆含Git LFS的BitBucket仓库时遇错误

咱们先聚焦核心矛盾：命令行Git能正常处理带LFS的BitBucket仓库，但Eclipse的eGit工具却报错，这大概率是eGit没正确关联到你已安装的git-lfs工具，或是缺少必要的LFS配置项。下面是几个针对性的解决步骤：

1. 检查并配置eGit的Git LFS支持 #

eGit需要明确启用LFS相关的过滤器配置，你可以这么操作：

• 打开Eclipse，进入Window > Preferences（Mac系统是Eclipse > Preferences）
• 导航到Team > Git > Configuration
• 切换到Global Settings（全局生效）或Repository Settings（针对当前仓库）
• 检查是否存在以下配置项，如果没有就点击Add Entry手动添加：
  • filter.lfs.clean：值设为 git-lfs clean -- %f
  • filter.lfs.smudge：值设为 git-lfs smudge -- %f
  • filter.lfs.process：值设为 git-lfs filter-process
  • filter.lfs.required：值设为 true

2. 确保eGit能找到git-lfs可执行文件 #

虽然你的git-lfs装在/usr/local/bin/git-lfs，但Eclipse的环境变量可能没包含这个路径，导致找不到工具：

• 最简单的办法：关闭Eclipse，然后从命令行启动它（比如Mac上运行open /Applications/Eclipse.app），这样Eclipse会继承命令行的环境变量，就能识别到git-lfs了。
• 也可以手动配置Eclipse环境：进入Window > Preferences > Run/Debug > String Substitution，添加PATH变量，把/usr/local/bin加入到值里；或者在Eclipse启动参数中添加-Dpath=/usr/local/bin:$PATH（路径根据你的系统调整）。

3. 更新eGit到最新版本 #

旧版eGit对Git LFS的支持可能存在兼容性问题，建议更新到最新稳定版：

• 进入Help > Eclipse Marketplace，搜索eGit，点击Update按钮完成更新，重启Eclipse后再尝试克隆。

4. 曲线救国：命令行克隆后导入Eclipse #

如果上面的方法都没效果，你可以先用已经验证有效的命令行方式克隆仓库，再导入到Eclipse：

• 命令行克隆完成后，在Eclipse中选择File > Import > Git > Projects from Git
• 选择Existing local repository，找到你本地克隆的仓库路径，完成导入。这样eGit会直接使用本地已配置好LFS的仓库，避免重新克隆时的问题。

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