如何通过Node.js API合并两个Git仓库并克隆至本地系统？

完全可以通过Node.js实现两个Git仓库的合并并将结果克隆到本地，借助Node.js的Git操作库就能完成这类任务，下面是具体实现方案：

方案选择：依赖库推荐 #

常用的Node.js Git操作库分两种类型：

• simple-git：基于系统Git命令的封装，语法和命令行Git高度一致，上手快，适合大多数场景
• isomorphic-git：纯JavaScript实现的Git库，无需系统安装Git，适合跨环境（如Electron应用、无Git环境的服务器）

方法一：使用simple-git实现 #

1. 安装依赖

npm install simple-git

2. 合并与克隆代码示例

const simpleGit = require('simple-git');
const path = require('path');
const fs = require('fs').promises;

// 配置两个仓库的地址和本地目标目录
const skeletonRepoUrl = 'https://github.com/你的用户名/skeleton-repo.git';
const generatedRepoUrl = 'https://github.com/你的用户名/generated-repo.git';
const localMergedDir = path.join(__dirname, 'merged-skeleton-generated');

async function mergeAndCloneRepos() {
  try {
    // 创建本地目标目录（不存在则自动创建）
    await fs.mkdir(localMergedDir, { recursive: true });

    const git = simpleGit(localMergedDir);

    // 克隆骨架代码仓库到本地
    await git.clone(skeletonRepoUrl, localMergedDir);

    // 将生成代码仓库添加为本地仓库的远程源
    await git.addRemote('generated-source', generatedRepoUrl);

    // 拉取生成代码仓库的主分支并合并到当前分支
    // 若存在冲突，此步骤会抛出错误，需手动进入目录解决冲突后执行 git.commit 完成合并
    await git.pull('generated-source', 'main');

    console.log('合并完成，结果已保存到本地目录:', localMergedDir);
  } catch (error) {
    console.error('合并过程出现错误:', error);
  }
}

// 执行合并操作
mergeAndCloneRepos();

方法二：使用isomorphic-git实现（无系统Git依赖） #

1. 安装依赖

npm install isomorphic-git fs-extra

2. 合并与克隆代码示例

const git = require('isomorphic-git');
const fs = require('fs-extra');
const path = require('path');

// 配置仓库地址和本地目录
const skeletonRepoUrl = 'https://github.com/你的用户名/skeleton-repo.git';
const generatedRepoUrl = 'https://github.com/你的用户名/generated-repo.git';
const localMergedDir = path.join(__dirname, 'merged-repo');

async function mergeReposWithoutSystemGit() {
  try {
    // 确保本地目录存在
    await fs.ensureDir(localMergedDir);
    // 初始化本地Git仓库
    await git.init({ fs, dir: localMergedDir });

    // 添加骨架仓库为远程源并拉取代码
    await git.addRemote({ fs, dir: localMergedDir, remote: 'skeleton', url: skeletonRepoUrl });
    await git.fetch({ fs, dir: localMergedDir, remote: 'skeleton' });
    await git.checkout({ fs, dir: localMergedDir, ref: 'refs/remotes/skeleton/main' });

    // 添加生成仓库为远程源并拉取代码
    await git.addRemote({ fs, dir: localMergedDir, remote: 'generated', url: generatedRepoUrl });
    await git.fetch({ fs, dir: localMergedDir, remote: 'generated' });

    // 合并生成仓库的主分支到当前分支
    // 存在冲突时需手动解决后提交
    await git.merge({ fs, dir: localMergedDir, ours: 'main', theirs: 'refs/remotes/generated/main' });

    console.log('合并完成，结果已保存到本地目录:', localMergedDir);
  } catch (error) {
    console.error('合并过程出现错误:', error);
  }
}

mergeReposWithoutSystemGit();

关键注意事项 #

• 冲突处理：如果两个仓库存在同名文件或代码冲突，合并操作会失败，此时需要手动进入本地目录，解决冲突后执行git commit完成合并
• 分支选择：示例中默认合并main分支，可根据实际需求修改为目标分支（如develop）
• 推送新仓库：若需要将合并后的代码推送到新仓库，可添加git.addRemote('new-repo', '新仓库地址')和git.push('new-repo', 'main')步骤

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