使用Astro部署GitHub Page时因Action配置问题导致构建上传失败

错误原因 #

你的GitHub仓库里只有配置文件和部署工作流，缺少Astro项目的核心文件（比如package.json、依赖锁文件package-lock.json/pnpm-lock.yaml等），导致部署Action无法自动检测包管理器，从而抛出错误。

解决步骤 #

1. 本地初始化完整的Astro项目 #

打开终端，选择一个空目录，运行对应包管理器的初始化命令：

• 用npm：

  npm create astro@latest .
  

• 用pnpm：

  pnpm create astro@latest .
  

按照终端向导选择基础模板即可，这会生成完整的Astro项目文件。

2. 确认Astro配置 #

确保astro.config.mjs内容如下（和你现有配置一致）：

import { defineConfig } from 'astro/config'

export default defineConfig({
  site: 'https://lafitteque.github.io',
  base: '',
})

3. 修正GitHub Actions工作流 #

打开.github/workflows/deploy.yml，取消注释with区块和package-manager配置，选择和你本地一致的包管理器，注意缩进格式：

- name: Install, build, and upload your site
  uses: withastro/action@v3
  with:
    # path: . # 保持默认即可
    # node-version: 20 # 保持默认即可
    package-manager: npm@latest # 如果你用pnpm，改成pnpm@latest

4. 提交所有文件到仓库 #

在终端运行以下命令，把所有项目文件推送到GitHub：

git add .
git commit -m "Initialize Astro project and fix deployment config"
git push origin main

完成以上步骤后，重新触发GitHub Actions部署，就能正常完成构建和部署了。

内容的提问来源于stack exchange，提问作者P.O.