如何在JGit中将File对象路径转换为Git兼容的相对路径

JGit 本身内置了路径处理能力，不需要手动实现跨平台分隔符转换逻辑，可按以下方案实现：

内置便捷方法实现（推荐） #

通用兼容版本（所有JGit版本均支持） #

• 首先从已初始化的Git或Repository实例中获取仓库工作区的根路径
• 将目标File对象转为标准化绝对路径后，和仓库根路径做相对计算，再替换分隔符为Git要求的正斜杠即可
  示例代码：

import org.eclipse.jgit.api.Git;
import java.nio.file.Path;

// 已有初始化完成的Git实例
Path repoRoot = git.getRepository().getWorkTree().toPath().toAbsolutePath().normalize();
// 待转换的目标File对象
Path targetAbsPath = targetFile.toPath().toAbsolutePath().normalize();
// 生成Git兼容的相对路径
String gitCompatiblePath = repoRoot.relativize(targetAbsPath).toString().replace('\\', '/');

高版本JGit简化方案（JGit 5.11+） #

JGit 5.11及以上版本新增了Repository#relativizeToWorkDir原生方法，可直接输出符合要求的Git路径，无需手动替换分隔符：

String gitCompatiblePath = git.getRepository().relativizeToWorkDir(targetFile.toPath());

注意事项 #

• 转换前需确认目标文件确实位于当前仓库的工作目录下，否则生成的相对路径会携带../父级标识，无法被log()的addPath方法识别
• Windows系统路径大小写不敏感，但Git对路径大小写敏感，转换后的路径需要和仓库中实际提交的路径大小写保持一致，否则会匹配不到提交记录
• 无需手动处理路径中的特殊字符，JGit的addPath方法会自动完成转义处理

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