如何部署到 GitHub Pages？

[jiusanzhou]

问题

如何将网站部署到 GitHub Pages？

解答

方法一：使用 GitHub Actions（推荐）

1. 创建 .github/workflows/deploy.yml 文件
2. 配置构建和部署步骤
3. 在仓库 Settings > Pages 中选择 GitHub Actions 作为源

示例 workflow：

name: Deploy to GitHub Pages

on:
  push:
    branches: [main]

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: '22'
      - uses: pnpm/action-setup@v4
        with:
          version: 10
      - run: pnpm install
      - run: pnpm build
        env:
          PAGES_BASE_PATH: "/your-repo-name"
      - uses: actions/upload-pages-artifact@v3
        with:
          path: ./out

  deploy:
    needs: build
    runs-on: ubuntu-latest
    environment:
      name: github-pages
    steps:
      - uses: actions/deploy-pages@v4

方法二：手动部署

1. 运行 pnpm build 生成静态文件到 out/ 目录
2. 将 out/ 目录内容推送到 gh-pages 分支