使用GitHub Actions部署私有仓库GitHub Pages遇Git凭证错误求助

一、核心问题分析 #

你遇到的fatal: could not read Username for 'https://github.com/': No such device or address错误，本质是dist目录的新Git环境没有可用的认证凭证：

• actions/checkout拉取代码时的凭证只在原仓库目录有效，你在dist目录新建仓库后，这个全新的Git环境没有继承任何认证信息，推送时自然无法通过GitHub的权限校验。
• 如果已经配置了PAT但没在dist目录的Git操作中正确使用，或者PAT缺少私有仓库所需的repo权限，也会触发这个错误。

二、修复方案（两种可选） #

方案1：复用原仓库环境，无需新建仓库 #

直接在原仓库中操作gh-pages分支，避免重复初始化仓库的麻烦：

# Workflow示例片段
- name: Build project
  run: npm run build

- name: Deploy to gh-pages
  run: |
    # 配置Git提交身份
    git config --global user.name "GitHub Actions"
    git config --global user.email "actions@github.com"
    # 创建并切换到gh-pages孤儿分支（不存在则新建）
    git checkout --orphan gh-pages
    # 清空分支原有内容
    git rm -rf .
    # 复制dist目录的构建产物到当前分支根目录
    cp -r dist/* .
    # 提交并强制推送（覆盖旧的gh-pages内容）
    git add .
    git commit -m "Deploy GitHub Pages"
    git push origin gh-pages --force

方案2：在dist目录的新仓库中注入凭证 #

如果坚持用Vite推荐的新建仓库方式，需要在推送时明确传入认证凭证：

1. 先在仓库的「Settings → Secrets and variables → Actions」中添加名为GH_PAGES_PAT的密钥，值为拥有repo权限的个人访问令牌（PAT）。
2. 修改部署脚本，在添加远程仓库时带上PAT：

# deploy.sh脚本内容
cd dist
git init
git add -A
git commit -m 'deploy'
# 用PAT替换认证信息，直接推送至gh-pages分支
git push -f https://${GH_PAGES_PAT}@github.com/你的用户名/你的仓库名.git master:gh-pages
cd -

3. 在Workflow中传递这个密钥：

- name: Deploy
  env:
    GH_PAGES_PAT: ${{ secrets.GH_PAGES_PAT }}
  run: bash deploy.sh

三、共享actions/checkout原始凭证的方法 #

actions/checkout会自动生成临时令牌GITHUB_TOKEN，你可以直接在dist目录的Git环境中复用它，无需额外创建PAT：

# 在dist目录初始化仓库后执行以下命令
git remote add origin https://x-access-token:${{ secrets.GITHUB_TOKEN }}@github.com/你的用户名/你的仓库名.git

这个临时令牌默认拥有私有仓库的repo权限，足以完成推送操作，是最简便的复用凭证方式。

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