Vercel 是一个为开发者提供工具、工作流和基础设施的平台，可以让你更快地构建和部署你的 Web 应用，而无需额外的配置。

vercel官网：vercel.com/，可以直接使用github账号登录。

Vercel 托管 Github page

Vercel 直接托管“纯静态仓库”（不构建，最省事）

你的GitHub仓库里只有已经生成好的静态文件，就让 Vercel 不执行构建 ，只把指定目录当站点根。

  1. 在 Vercel → Add New → Project → Import Git Repository 选你的仓库。
  2. 在 “Configure Project” 里：
    • Framework Preset ：Other
    • Install Command ：留空
    • Build Command ：留空（很关键，表示不构建）
    • Output Directory ：
    • 如果 静态文件在仓库根 （index.html 在根）：填 .
    • 如果 静态文件在仓库的 public/ 子目录 ：填 public
  3. 点 Deploy 就完成了。以后你只要继续往这个仓库推送静态文件，Vercel 会自动发布。

你现在 GitHub Pages 是个人主页（根路径 /），如果你的仓库根就是这些文件，Output 直接填 . 就行。

GitHub Actions：检测到你推“静态仓库”就自动发 Vercel

如果你仍把静态文件推到 GitHub，可以加个极简工作流，让它自动把仓库内容部署到 Vercel（不构建）。

在仓库中新增 .github/workflows/deploy-vercel.yml：

name: Deploy static to Vercel (no build)

on:
  push:
    branches: [ main ]
  workflow_dispatch:

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Install Vercel CLI
        run: npm i -g vercel@latest

      - name: Pull Vercel project settings
        run: vercel pull --yes --environment=production --token ${{ secrets.VERCEL_TOKEN }}
        env:
          VERCEL_ORG_ID: ${{ secrets.VERCEL_ORG_ID }}
          VERCEL_PROJECT_ID: ${{ secrets.VERCEL_PROJECT_ID }}

      # 如果你的静态文件在仓库根，改成 "vercel deploy ."
      - name: Deploy current repo as static site
        run: vercel deploy public --prod --yes --token ${{ secrets.VERCEL_TOKEN }}
        env:
          VERCEL_ORG_ID: ${{ secrets.VERCEL_ORG_ID }}
          VERCEL_PROJECT_ID: ${{ secrets.VERCEL_PROJECT_ID }}

在 GitHub → Settings → Secrets and variables → Actions 新增 3 个机密：

  • VERCEL_TOKEN（Vercel 账户里创建的 access token）
  • VERCEL_ORG_ID、VERCEL_PROJECT_ID（在对应项目的 Settings 里能看到）

如果你的仓库根就是静态站点，把 vercel deploy public 改为 vercel deploy .。

小贴士

  • 同时保留 GitHub Pages：完全没冲突。Vercel 会有 xxx.vercel.app 域名；你可以在导航里放“镜像”链接。

  • 缓存优化（可选）：根目录放一个 vercel.json 给静态资源长缓存（HTML 不缓存），提升访问体验：

    { "version": 2, "cleanUrls": true,
      "headers": [
        { "source": "/(.*)\\.(js|css|png|jpg|jpeg|webp|svg|gif)",
          "headers": [{ "key": "Cache-Control", "value": "public, max-age=31536000, immutable"}] }
      ]
    }

如果找不到VERCEL_ORG_ID，请看下面的方案

在 Vercel 面板里找到 ORG（账号/团队）ID

如果是个人账号：

  1. 右上角头像 → Account Settings（账户设置）。
  2. General / Account 页面里能看到 User ID（有时也显示为 Team/Org ID），形如 team_xxxxx 或 user_xxxxx。这就是 VERCEL_ORG_ID。

如果是在团队下：

  1. 左上角团队切换（或头像菜单）进入 Team Settings。
  2. General 页面里能看到 Team ID（形如 team_xxxxx）。它就是 VERCEL_ORG_ID。

把这个 ID 连同你已有的 VERCEL_PROJECT_ID 和 VERCEL_TOKEN 一起放进 GitHub 仓库的 Settings → Secrets and variables → Actions 即可。