如何通过NodeGit实现git clean -f -d的仓库清理效果？

嘿，我来帮你搞定这个问题！要完全清除仓库的所有本地变更（包括已追踪文件的修改和未追踪的文件/目录），你需要分两步操作：先把已追踪文件重置到当前HEAD的状态，再删除所有未追踪的内容——这就对应了git reset --hard加上git clean -f -d的组合效果。

1. 重置已追踪文件到最新提交状态 #

这一步会把所有已追踪文件的工作区和暂存区修改全部抹除，回到最近一次提交的状态。用NodeGit的reset方法就能实现：

async function resetTrackedFilesToHead(repo) {
  // 获取当前HEAD指向的提交
  const headCommit = await repo.getHeadCommit();
  // 执行硬重置，覆盖工作区和暂存区
  await repo.reset(headCommit, NodeGit.Reset.TYPE.HARD);
}

这里的NodeGit.Reset.TYPE.HARD是关键，它会同时重置暂存区和工作区，和git reset --hard的行为完全一致。

2. 清理未追踪的文件与目录 #

NodeGit没有提供直接对应git clean -f -d的API，所以我们需要自己实现：先获取仓库的状态，筛选出未追踪的项，再递归删除这些文件和目录。

const fs = require('fs').promises;
const path = require('path');

async function removeUntrackedContent(repo) {
  // 获取仓库所有文件的状态
  const statusList = await repo.getStatus();

  for (const status of statusList) {
    // 只处理未追踪且未被.gitignore忽略的项
    if (status.isNew()) {
      const fullPath = path.join(repo.workdir(), status.path());

      try {
        const fileStats = await fs.stat(fullPath);
        if (fileStats.isDirectory()) {
          // 递归删除目录（对应git clean -d）
          await fs.rm(fullPath, { recursive: true, force: true });
        } else {
          // 删除单个文件（对应git clean -f）
          await fs.unlink(fullPath);
        }
      } catch (error) {
        console.error(`删除${fullPath}失败:`, error);
      }
    }
  }
}

这里的逻辑和git clean -f -d完全对齐：

• status.isNew()筛选出未追踪的文件/目录
• fs.rm的recursive: true处理目录删除，force: true强制删除（对应-f）
• 自动跳过被.gitignore忽略的文件（因为isNew()不会标记已忽略的项）

3. 组合两步完成完整清理 #

把上面两个函数组合起来，就能实现一键清除所有本地变更的效果：

async function fullCleanRepo(repo) {
  await resetTrackedFilesToHead(repo);
  await removeUntrackedContent(repo);
  console.log("仓库已完成清理，效果等同于执行`git reset --hard && git clean -f -d`");
}

重要注意事项 #

• 操作不可逆：这个清理操作会永久删除本地修改和未追踪内容，执行前一定要确认没有需要保留的文件！
• 确保NodeGit版本：如果你的NodeGit版本较旧，部分API可能有变化，建议使用最新稳定版。
• 权限问题：删除目录或文件时可能遇到权限限制，记得做好错误捕获和提示。

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