You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

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

额外检查:

  1. 进入你的GitHub仓库 → 点击「Settings」→ 找到「Pages」选项
  2. 确认「Source」选择的是「GitHub Actions」,而非某个分支

内容的提问来源于stack exchange,提问作者Charles

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.06 05:15:43