GitHub Action执行npm run build无构建输出问题求助

核心原因 #

GitHub Action的运行环境是临时虚拟机，构建生成的dist文件夹仅存在于当前Job的运行容器中，不会自动同步到远程仓库。必须手动添加提交、推送步骤，才能将构建产物同步回仓库。

具体解决步骤 #

1. 修复仓库克隆配置
   默认的actions/checkout@v3是浅克隆模式，会导致后续提交失败。需要修改配置，确保完整克隆仓库：

- uses: actions/checkout@v3
  with:
    fetch-depth: 0

2. 添加构建产物的提交推送流程
   在run: ls步骤之后，新增以下步骤，配置Git身份并推送dist文件夹：

- name: 配置Git身份
  run: |
    git config --global user.name "GitHub Actions"
    git config --global user.email "actions@github.com"
- name: 提交dist文件夹
  run: |
    git add dist/
    git commit -m "自动构建：更新dist文件夹" || echo "没有需要提交的变更"
- name: 推送变更到main分支
  run: git push origin main

3. 检查.gitignore规则
   确认仓库根目录的.gitignore文件中没有排除dist/目录，如果存在对应的排除规则，需要删除，否则git add会忽略该文件夹。

4. 确认Workflow权限
   进入仓库的「Settings」→「Actions」→「General」→「Workflow permissions」，设置为Read and write permissions，确保Action拥有推送代码的权限。

修改后的完整工作流配置 #

name: Rollup

on:
  push:
    branches: [ "main" ]
  pull_request:
    branches: [ "main" ]

jobs:
  build:
    runs-on: ubuntu-latest
    strategy:
      matrix:
        node-version: [18.x]

    steps:
    - uses: actions/checkout@v3
      with:
        fetch-depth: 0
    - name: Use Node.js ${{ matrix.node-version }}
      uses: actions/setup-node@v3
      with:
        node-version: ${{ matrix.node-version }}
        cache: 'npm'
    - run: npm install
    - run: npm run build --if-present
    - run: ls
    - name: 配置Git身份
      run: |
        git config --global user.name "GitHub Actions"
        git config --global user.email "actions@github.com"
    - name: 提交dist文件夹
      run: |
        git add dist/
        git commit -m "自动构建：更新dist文件夹" || echo "没有需要提交的变更"
    - name: 推送变更到main分支
      run: git push origin main

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