Github Actions克隆仓库报错could not read Username问题求助

数据老陈

2026-9-30

GitHub Actions文档部署报错修复方案

报错根因

执行git clone时使用普通HTTPS仓库地址，GitHub Actions运行环境默认无身份凭据，无法完成需读写权限的仓库克隆操作，触发身份校验失败。

修复方法一：修改现有git clone命令

无需额外配置Secrets，直接替换原有clone命令，使用GitHub内置变量自动注入认证信息与仓库地址：

# 原命令
git clone https://github.com/<user>/<repo>.git --branch gh-pages --single-branch gh-pages
# 替换为
git clone https://x-access-token:${{ secrets.GITHUB_TOKEN }}@github.com/${{ github.repository }}.git --branch gh-pages --single-branch gh-pages

git身份配置也可直接使用官方Actions机器人身份，无需填写私人信息：

git config --local user.email "github-actions[bot]@users.noreply.github.com"
git config --local user.name "github-actions[bot]"

修复方法二：使用标准化部署Action（更推荐）

直接替换原有Commit documentation changes和Push changes两个步骤，改用成熟的部署Action，自动处理全部git逻辑，无需手动编写命令：

- name: Deploy to GitHub Pages
  uses: peaceiris/actions-gh-pages@v3
  with:
    github_token: ${{ secrets.GITHUB_TOKEN }}
    publish_dir: ./docs/_build/html

该Action会自动完成gh-pages分支拉取、内容同步、生成.nojekyll文件、提交推送全流程，兼容性更高。