部署到 Vercel 指南

部署到 Vercel 指南

项目已配置好部署所需的文件

项目已经包含以下配置文件:

  1. vercel.json - Vercel 构建配置
    • 构建命令:bundle install && bundle exec jekyll build
    • 输出目录:_site
  2. package.json - npm 依赖和脚本
    • 包含 Vercel CLI 作为开发依赖

部署步骤

方法一:命令行部署(推荐)

  1. 登录 Vercel
    npx vercel login --github
    

    或者使用 email:

    npx vercel login
    
  2. 部署到生产环境
    npx vercel --prod --yes
    

方法二:通过 Vercel 网站部署

  1. 访问 vercel.com
  2. 使用 GitHub 账号登录
  3. 点击 “Add New Project”
  4. 导入你的 GitHub 仓库:pea1ce/pea1ce.github.io
  5. Vercel 会自动检测 vercel.json 配置
  6. 点击 “Deploy”

方法三:使用 Vercel Token

如果你有 Vercel Token:

npx vercel --token YOUR_VERCEL_TOKEN --prod --yes

获取 Token:

  1. 访问 https://vercel.com/account/tokens
  2. 创建新的 Token
  3. 复制 Token 并在上面命令中替换 YOUR_VERCEL_TOKEN

后续步骤

部署成功后:

  1. Vercel 会提供一个生产环境 URL(如:mysite-xxx.vercel.app)
  2. 你可以在 Vercel Dashboard 中配置自定义域名
  3. 每次 push 到 GitHub 主分支,Vercel 会自动重新部署

自定义域名配置

在 Vercel Dashboard 中:

  1. 进入项目设置
  2. 点击 “Domains”
  3. 添加你的域名:heyiping.cn
  4. 按照提示配置 DNS 记录

环境变量(如需要)

如果需要设置环境变量:

npx vercel env add VARIABLE_NAME

或在 Vercel Dashboard 的项目设置中添加。

本地开发

npx vercel dev

查看部署状态

npx vercel ls

注意事项

  • 确保 Ruby 和 Bundler 在 Vercel 构建环境中可用(已在 vercel.json 配置)
  • Jekyll 构建输出在 _site 目录
  • Vercel 会缓存构建结果以加快部署速度