如何为Poetry配置GitHub PAT以访问私有GitHub依赖仓库？

方法一：直接在依赖URL中嵌入PAT #

这是最直接且不易出问题的方式，适合临时或特定项目使用：

• 修改pyproject.toml中的私有依赖条目，把PAT直接拼接到HTTPS URL里：

  [tool.poetry.dependencies]
  python = "^3.10"
  your-private-package = { git = "https://<你的PAT>@github.com/用户名/私有仓库名.git", branch = "main" }
  

• 替换<你的PAT>为实际生成的GitHub个人访问令牌（需确保PAT拥有repo权限）
• 执行poetry install即可

方法二：配置Git全局凭证（绕过Credential Manager问题） #

如果不想在配置文件中明文写PAT，可以直接配置Git使用PAT作为HTTPS凭证：

1. 打开终端，执行以下命令（替换占位符）：

   git config --global credential.helper store
   git config --global url."https://<你的PAT>@github.com/".insteadOf "https://github.com/"
   

2. 这个配置会让Git所有对GitHub的HTTPS请求自动带上PAT，Poetry调用Git时会自动复用这个凭证
3. 执行poetry install测试，无需额外环境变量

方法三：正确设置Poetry专属环境变量（针对GITHUB_TOKEN无效的情况） #

有些场景下Poetry不会自动读取GITHUB_TOKEN，需要明确指定Git的凭证环境变量：

• 在执行poetry install前，临时设置环境变量：

  # Linux/macOS
  export GIT_ASKPASS=/bin/true
  export GITHUB_TOKEN=<你的PAT>
  poetry install
  
  # Windows（PowerShell）
  $env:GIT_ASKPASS="true"
  $env:GITHUB_TOKEN="<你的PAT>"
  poetry install
  

• 或者把这两个变量加入系统/用户环境变量，永久生效

排查Git Credential Manager卡顿的问题 #

如果必须使用Credential Manager，尝试重置它：

1. 执行以下命令清除现有凭证：

   git credential-manager-core erase
   

2. 重新配置Credential Manager：

   git config --global credential.helper manager-core
   

3. 再次执行poetry install，此时会弹出凭证输入框，输入GitHub用户名和PAT即可

注意：生成PAT时，务必只勾选必要的权限（repo权限足够访问私有仓库），避免权限过大带来安全风险。

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