如何使用JGIT将文件从暂存区移除转为未暂存状态？

JGIT 提供了对应的操作方法，可以将指定文件从暂存区移除、转为未暂存状态，对应原生 Git 的 git reset HEAD <文件路径> 能力。

具体实现步骤 #

• 首先初始化 JGIT 的 Git 实例，绑定你的本地仓库路径：

Git git = Git.open(new File("本地仓库的根目录绝对路径"));

• 调用 ResetCommand 执行暂存区重置操作，选择 MIXED 重置模式（仅重置暂存区，保留工作区文件内容，是默认重置模式），传入要移除的文件相对路径（相对于仓库根目录）：

try (Git git = Git.open(new File("/path/to/local/repo"))) {
    // 单个文件移除暂存
    git.reset()
       .setRef(Constants.HEAD)
       .setMode(ResetCommand.ResetType.MIXED)
       .addPath("src/test/Test.java")
       // 批量移除就多次调用 addPath 传入不同路径即可
       //.addPath("pom.xml")
       .call();
} catch (IOException | GitAPIException e) {
    // 自定义异常处理
    e.printStackTrace();
}

注意事项 #

• 代码中用到的Constants是org.eclipse.jgit.lib.Constants类下的常量，ResetCommand属于org.eclipse.jgit.api包，使用前需要先引入对应依赖
• 传入的文件路径必须是相对于仓库根目录的相对路径，不能传绝对路径
• 如果你需要清空整个暂存区，不需要调用addPath()方法，直接执行reset命令即可
• 该操作不会修改工作区的文件内容，仅变更暂存区状态，完全符合需求

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