如何使用PAT凭证从私有Git仓库安装R包

以下方法均经过实测，不需要依赖GitHub专属的配置逻辑：

• 方案1：URL嵌入凭证（单次安装最快）
  直接把用户名和PAT按格式拼入仓库HTTPS地址，传入install_git即可，不需要额外配置参数：

  # 替换为你的实际信息，PAT建议从环境变量读取避免硬编码泄露
  user <- Sys.getenv("BITBUCKET_USER")
  pat <- Sys.getenv("BITBUCKET_PAT")
  repo_path <- "bitbucket.公司内网域名.com/团队名/r包仓库名.git"
  
  remotes::install_git(url = paste0("https://", user, ":", pat, "@", repo_path))
  

  注意：如果你的用户名或PAT包含@、:、/这类URL特殊字符，先调用utils::URLencode()对凭证部分做编码，否则会出现URL解析错误。

• 方案2：透传credentials参数（更规范，不暴露凭证到URL）
  remotes::install_git()的credentials参数会直接传递给底层Git客户端，把PAT作为密码传入即可，不需要拼到URL里：

  remotes::install_git(
    url = "https://bitbucket.公司内网域名.com/团队名/r包仓库名.git",
    credentials = c(
      username = Sys.getenv("BITBUCKET_USER"),
      password = Sys.getenv("BITBUCKET_PAT")
    )
  )
  

  这个方法不会把PAT明文显示在进程命令列表、R历史记录里，安全性更高。

• 方案3：全局Git凭证配置（长期使用免重复传参）
  如果需要频繁访问内部Bitbucket仓库，可以配置Git全局凭证存储，后续所有Git操作（包括remotes装包）都会自动完成认证，不需要每次传PAT：

  1. 先在R里执行一次命令开启凭证存储：

     system("git config --global credential.helper store")
     

  2. 第一次安装时直接传不带凭证的仓库URL，按终端提示输入用户名，密码栏填入你的PAT即可，后续Git会自动保存凭证，无需重复输入。

常见踩坑排查 #

• 生成PAT时务必勾选对应仓库的读取权限，至少需要Repositories: Read权限，否则会返回403权限不足错误
• 如果之前输错过凭证，先清理系统里存储的旧凭证：Windows去「凭据管理器」删对应Bitbucket域名的条目，macOS去「钥匙串访问」删对应条目，Linux直接编辑~/.git-credentials文件删除对应行即可
• 不要照搬install_github()相关的GITHUB_PAT环境变量配置，这套逻辑只对GitHub官方域名生效，对自建内部Git服务器无效

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