如何从NodeJs服务端将指定目录自动推送至Git（GitHub）仓库

方案1：原生调用Git命令（无需额外Git依赖库，学习成本最低） #

这个方案直接通过Node.js内置的child_process模块调用系统Git命令，和手动在终端敲Git命令的逻辑完全一致，不需要额外学习第三方库的专属API，非常适合Node.js新手使用。

前置要求 #

• 运行Node.js服务的环境已安装Git，且完成GitHub账号凭据配置（推荐用SSH密钥，避免交互输入密码）
• 要推送的文件所在的目录已完成Git初始化，绑定了对应的GitHub远程仓库

示例代码 #

const { exec } = require('child_process');
// 配置项：替换为你自己的实际参数
const GIT_WORK_DIR = '/path/to/your/generated/files'; // 生成文件存放的目录，也是本地Git仓库目录
const TARGET_PUSH_DIR = './output'; // 要推送的指定目录，相对于上面的工作目录
const REMOTE_NAME = 'origin';
const TARGET_BRANCH = 'main';
const COMMIT_MSG = `自动提交：${new Date().toLocaleString()}`;

// 按顺序执行Git命令
const gitCommands = [
  `cd ${GIT_WORK_DIR}`,
  'git pull', // 先拉取最新代码避免冲突
  `git add ${TARGET_PUSH_DIR}`, // 只添加指定目录的改动
  `git commit -m "${COMMIT_MSG}"`,
  `git push ${REMOTE_NAME} ${TARGET_BRANCH}`
];

exec(gitCommands.join(' && '), (error, stdout, stderr) => {
  if (error) {
    console.error(`推送执行出错: ${error.message}`);
    return;
  }
  if (stderr) {
    console.error(`Git命令输出异常: ${stderr}`);
    return;
  }
  console.log('文件推送成功', stdout);
});

方案2：使用git-js（simple-git）库实现 #

如果你需要更精细化的Git操作控制，可以使用这个封装库，它的API和原生Git命令一一对应，上手门槛远低于NodeGit。

前置操作 #

先安装依赖：
npm install simple-git

示例代码 #

const simpleGit = require('simple-git');
// 配置项
const GIT_WORK_DIR = '/path/to/your/generated/files';
const TARGET_PUSH_DIR = './output';
const REMOTE_NAME = 'origin';
const TARGET_BRANCH = 'main';
const COMMIT_MSG = `自动提交：${new Date().toLocaleString()}`;

const git = simpleGit(GIT_WORK_DIR);

async function pushToGitHub() {
  try {
    await git.pull();
    await git.add(TARGET_PUSH_DIR);
    await git.commit(COMMIT_MSG);
    // 对应官方给出的 `.push(remote, branch[, options])` 语法
    // 第三个参数为可选配置，比如需要强制推送可以传 ['--force']
    await git.push(REMOTE_NAME, TARGET_BRANCH);
    console.log('文件推送成功');
  } catch (err) {
    console.error('推送失败：', err);
  }
}

pushToGitHub();

注意事项 #

• 如果你不需要保留其他文件的改动，只需要提交指定目录的内容，可以在git add之前执行git reset HEAD .清空暂存区，避免意外提交其他改动
• 首次部署前建议手动在运行环境的对应目录执行一次Git推送流程，确认凭据、仓库绑定都正常，再用Node.js调用
• 如果你的生成文件是每次全量覆盖旧文件，可以按需配置.gitignore过滤不需要提交的缓存、日志类文件

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