Node.js中如何使用simple-git结合Personal Access Token克隆GitHub私有仓库？

我完全懂你遇到的问题！之前我也碰到过类似情况——用simple-git克隆私有仓库时，只生成了.git相关目录，却看不到实际代码，而且还没报错，确实挺迷惑人的。这本质上就是认证缺失导致的不完全克隆：公共仓库不需要权限验证，所以能正常拉取所有内容，但私有仓库需要权限才能获取完整代码，没认证的话只会克隆基础的.git结构，不会拉取实际文件。

下面给你两种靠谱的解决方法，都是用你已经生成的Personal Access Token（PAT）来做认证：

方法一：把PAT嵌入到仓库URL中 #

这是最直接的方式，把你的PAT作为认证信息拼接到HTTPS仓库URL里，格式如下：

https://<你的PAT>@github.com/<用户名>/<私有仓库名>.git

具体代码实现：

const simpleGit = require('simple-git');
const git = simpleGit();

// 从环境变量读取PAT（千万不要硬编码！）
const githubPat = process.env.GITHUB_PAT;
// 替换成你的私有仓库地址
const privateRepoUrl = `https://${githubPat}@github.com/your-username/your-private-repo.git`;

git.clone(privateRepoUrl, './repository', (error) => {
  if (error) {
    console.error('克隆出错啦:', error);
  } else {
    console.log('私有仓库克隆成功！');
  }
});

方法二：使用simple-git的credentials配置选项 #

如果你不想修改仓库URL，可以通过simple-git的配置项直接传入认证信息：

const simpleGit = require('simple-git');
const git = simpleGit();

const privateRepoUrl = 'https://github.com/your-username/your-private-repo.git';

git.clone(privateRepoUrl, './repository', {
  credentials: {
    // PAT作为用户名传入，密码字段可以留空
    username: process.env.GITHUB_PAT,
    password: ''
  }
}, (error) => {
  if (error) {
    console.error('克隆失败:', error);
  } else {
    console.log('私有仓库克隆完成！');
  }
});

重要注意事项 #

• PAT权限要足够：生成PAT时，一定要勾选repo权限（针对私有仓库的读写权限），否则即使传入PAT也会提示权限不足。
• 保护好你的PAT：绝对不要把PAT直接写在代码里，一定要用环境变量管理，避免泄露后别人能操作你的仓库。
• 排查问题：如果还是不行，可以开启simple-git的调试模式，查看克隆过程的详细日志，方便定位问题：

  const git = simpleGit({ debug: console.log });
  

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