GitHub 个人访问令牌（PAT）生成及 R 环境配置指南

GitHub 个人访问令牌（PAT）生成及 R 环境配置指南

1. 生成 GitHub 个人访问令牌（PAT）

1. 访问 GitHub 设置页面：打开浏览器，访问 GitHub Personal Access Tokens。
2. 登录 GitHub 账户：如果尚未登录，请输入用户名和密码。
3. 生成新的个人访问令牌（PAT）：
   • 在 Personal access tokens 页面，点击 Generate new token。
   • Note：命名令牌，例如 R-Access-Token。
   • Expiration：选择过期时间（如 30 天、90 天或 No expiration）。
   • Select Scopes：至少选择以下权限：
     • repo（允许访问私有仓库）
     • workflow（允许访问 GitHub Actions）
     • read:packages / write:packages（读取/写入包）
     • read:org（读取组织信息，必要时选择）
4. 生成令牌：点击 Generate token 按钮。
5. 保存令牌：复制生成的令牌并保存，因为它只会显示一次。

2. 配置 GitHub 凭证

在 R 中配置凭证

使用 gitcreds 包管理凭证。

install.packages("gitcreds")
library(gitcreds)

运行 gitcreds::gitcreds_set() 并按提示输入 GitHub 用户名和 PAT。

配置 Git 远程 URL 和凭证

在终端中启用 HTTPS 协议和凭证缓存：

git remote set-url origin https://github.com/username/repository.git
git config --global credential.helper store

执行 Git 操作时，Git 会提示输入用户名和 PAT，之后将自动缓存。

3. 安装 GitHub 包

使用 remotes 包安装 GitHub 上的 R 包：

remotes::install_github("mojaveazure/seurat-disk")

若配置正确，remotes 会使用存储的凭证进行身份验证。

4. 验证配置

gitcreds::gitcreds_get()

此命令可显示当前存储的 GitHub 凭证信息。

5. 常见问题

• HTTP error 401: Bad credentials：通常因 PAT 配置错误或过期导致，请重新生成并确保权限正确。
• Token 授权问题：确保在 GitHub 设置中选择了足够的 Scope。

总结

通过生成 PAT 并配置到 R 环境，可在 R 中安全使用 GitHub 凭证进行包安装、推送和拉取操作。关键步骤包括生成 PAT、使用 gitcreds 配置凭证、使用 remotes 安装包。