React站点GitHub Actions部署异常:仅展示master分支README文件
解决React站点GitHub Actions自动化部署问题
你当前使用的是Jekyll专属的GitHub Pages工作流,但你的站点是React项目,Jekyll会自动将README渲染为首页,导致线上只显示master分支的README。以下是适配React项目的自动化部署工作流,实现master分支推送时自动构建并部署:
name: Deploy React Site to GitHub Pages on: push: branches: ["master"] workflow_dispatch: permissions: contents: read pages: write id-token: write concurrency: group: "pages" cancel-in-progress: true jobs: build-and-deploy: runs-on: ubuntu-latest steps: - name: 拉取代码 uses: actions/checkout@v3 - name: 设置Node.js环境 uses: actions/setup-node@v3 with: node-version: '18' # 可根据你的项目需求调整Node版本 cache: 'npm' # 缓存npm依赖,加快构建速度 - name: 安装依赖 run: npm install - name: 构建React项目 run: npm run build # 对应你本地的构建命令,通常是npm run build - name: 配置GitHub Pages uses: actions/configure-pages@v3 - name: 上传构建产物 uses: actions/upload-pages-artifact@v2 with: path: './build' # React默认构建产物目录是build,若你有自定义路径请修改 - name: 部署到GitHub Pages uses: actions/deploy-pages@v2
关键说明:
- 移除了所有Jekyll相关步骤,替换为React项目的标准构建流程:拉取代码 → 设置Node环境 → 安装依赖 → 构建项目
- 确保
npm run build是你项目中正确的构建命令,若你的package.json里构建命令是其他名称(比如deploy),请对应修改 - 上传产物的路径
./build是React项目的默认构建输出目录,若你在项目中自定义了构建输出路径,需同步修改此处 - 新增
deploy-pages步骤,负责将构建产物部署到GitHub Pages
额外检查:
- 进入你的GitHub仓库 → 点击「Settings」→ 找到「Pages」选项
- 确认「Source」选择的是「GitHub Actions」,而非某个分支
内容的提问来源于stack exchange,提问作者Charles
相关产品推荐
相关产品推荐

