Vue3+Vite项目GitHub Actions部署Firebase失败求助

云上老周

2026-7-11

解决方案：GitHub Actions部署Firebase Hosting提示dist目录不存在

核心问题是你的GitHub Actions工作流缺少依赖安装和项目构建步骤——手动部署时你会先执行npm install和npm run build生成dist目录，但Actions里直接跳去部署，自然找不到这个文件夹。

修改后的GitHub Actions工作流配置

name: Deploy to Firebase Hosting on merge
'on':
  push:
    branches:
      - main
jobs:
  build_and_deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      # 新增：配置Node环境（版本换成你项目实际使用的，比如18/20）
      - uses: actions/setup-node@v4
        with:
          node-version: '20'
          cache: 'npm' # 缓存依赖，加速构建
      # 新增：安装项目依赖
      - run: npm install
      # 新增：构建项目生成dist目录
      - run: npm run build
      # 原部署步骤
      - uses: FirebaseExtended/action-hosting-deploy@v0
        with:
          repoToken: '${{ secrets.GITHUB_TOKEN }}'
          firebaseServiceAccount: '${{ secrets.FIREBASE_SERVICE_ACCOUNT_ASXVEC }}'
          channelId: live
          projectId: asxvec

额外检查点

确认package.json里的build脚本正确，应该是：
```
"scripts": {
  "build": "vite build"
}
```
确保dist目录在.gitignore里，不要提交到Git仓库——每次构建都会生成对应代码版本的最新产物，Actions里的构建才是正确的部署源。
如果项目用pnpm/yarn，把npm install和npm run build换成对应命令（比如pnpm install、pnpm run build）。