使用FetchContent访问私有Git仓库遇认证问题求助

当用CMake的FetchContent模块拉取私有GitHub仓库时，出现Git克隆失败，报错无法读取密码、执行提示脚本失败，最终CMake配置无法完成。

CMakeLists.txt 代码： #

include(FetchContent)

FetchContent_Declare(
    {repository}
    GIT_REPOSITORY https://{username}@github.com/{company}/{repository}
    USES_TERMINAL_DOWNLOAD ON
)

FetchContent_GetProperties({repository})
if(NOT {repository}_POPULATED)
    FetchContent_Populate({repository})
endif()

错误输出： #

MSBuild version 17.3.1+2badb37d1 for .NET Framework
  Performing download step (git clone) for '{repository}-populate'
  Cloning into '{repository}-src'...
  bash: line 1: /dev/tty: No such device or address
CUSTOMBUILD : error : failed to execute prompt script (exit code 1) [C:\git\.....vcxproj]
  fatal: could not read Password for 'https://{username}@github.com': No such file or directory

 ...

  -- Had to git clone more than once: 3 times.
  CMake Error at {repository}-subbuild/{repository}-populate-prefix/tmp/{repository}-populate-gitclone.cmake:39 (message):
    Failed to clone repository: 'https://{username}@github.com/{company}/{repository}'

...

-- Configuring incomplete, errors occurred!

解决方法： #

• 配置Git凭证缓存
  先在本地设置Git凭证助手，让Git记住账号密码：

  # Windows系统用这个
  git config --global credential.helper wincred
  # macOS用这个
  # git config --global credential.helper osxkeychain
  # Linux可以临时缓存1小时
  # git config --global credential.helper cache --timeout=3600
  

  配置完手动克隆一次目标私有仓库，输入账号密码完成认证，之后FetchContent就能自动复用这个凭证，不用再手动输入。

• 用个人访问令牌替换密码
  在GitHub生成一个有仓库读取权限的个人访问令牌（PAT），然后修改仓库URL：

  FetchContent_Declare(
      {repository}
      GIT_REPOSITORY https://{username}:{你的PAT令牌}@github.com/{company}/{repository}
      USES_TERMINAL_DOWNLOAD ON
  )
  

  注意别把带令牌的代码提交到公共仓库，建议用CMake变量传令牌：

  set(PRIVATE_REPO_TOKEN "" CACHE STRING "GitHub私有仓库访问令牌")
  FetchContent_Declare(
      {repository}
      GIT_REPOSITORY https://{username}:${PRIVATE_REPO_TOKEN}@github.com/{company}/{repository}
      USES_TERMINAL_DOWNLOAD ON
  )
  

  执行CMake时通过命令行传入令牌：cmake -DPRIVATE_REPO_TOKEN=你的令牌 ..

• 切换到SSH协议拉取
  改用SSH URL，提前把本地SSH公钥添加到GitHub账户：

  FetchContent_Declare(
      {repository}
      GIT_REPOSITORY git@github.com:{company}/{repository}.git
      USES_TERMINAL_DOWNLOAD ON
  )
  

  只要SSH密钥配置正确，Git就能自动完成认证，不需要输入密码。

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