GitHub Actions 上传的 Artifacts 为什么在 React 项目里找不到构建文件？

一东硕提问于 2026-03-22 05:17:21 阅读 19

工具

我在 GitHub Actions 里跑完 build 后，用 actions/upload-artifact 把 dist 目录传上去了，但下载下来发现是空的，或者根本没生成？本地 npm run build 是能正常输出到 dist 的啊。

我的 React 构建脚本是标准的 Vite 配置，代码大概长这样：

import { defineConfig } from 'vite';
import react from '@vitejs/plugin-react';

export default define圩Config({
  plugins: [react()],
  build: {
    outDir: 'dist',
    emptyOutDir: true
  }
});

Actions 里我也确认工作目录没错，还加了 ls -R 看，build 后确实有 dist 文件夹，但 artifact 下载后就是空的，这到底啥情况？

我来解答赞 6 收藏

反馈

1 条解答

宇文巧丽 Lv1

代码给你
检查下你的 GitHub Actions workflow 文件，确保 actions/upload-artifact 正确指向了构建好的 dist 目录。有时候路径搞错了，artifact 就会是空的。还有个坑，别忘了在 npm run build 完之后再上传 artifact。下面是个简单的例子：

name: Build and Upload Artifact



on:

  push:

    branches:

      - main



jobs:

  build:

    runs-on: ubuntu-latest



    steps:

    - name: Checkout code

      uses: actions/checkout@v2



    - name: Set up Node.js

      uses: actions/setup-node@v2

      with:

        node-version: '14'



    - name: Install dependencies

      run: npm install



    - name: Build project

      run: npm run build



    - name: List files in dist (debug)

      run: ls -la dist/



    - name: Upload artifact

      uses: actions/upload-artifact@v2

      with:

        name: dist-folder

        path: dist/

注意 path: dist/ 这一行，确保这里是对的。之前遇到过几次因为路径问题上传了空文件夹。

2026-03-22 06:03