部署到 Vercel 指南
项目已配置好部署所需的文件
项目已经包含以下配置文件:
- vercel.json - Vercel 构建配置
- 构建命令:
bundle install && bundle exec jekyll build - 输出目录:
_site
- 构建命令:
- package.json - npm 依赖和脚本
- 包含 Vercel CLI 作为开发依赖
部署步骤
方法一:命令行部署(推荐)
- 登录 Vercel
npx vercel login --github或者使用 email:
npx vercel login - 部署到生产环境
npx vercel --prod --yes
方法二:通过 Vercel 网站部署
- 访问 vercel.com
- 使用 GitHub 账号登录
- 点击 “Add New Project”
- 导入你的 GitHub 仓库:
pea1ce/pea1ce.github.io - Vercel 会自动检测
vercel.json配置 - 点击 “Deploy”
方法三:使用 Vercel Token
如果你有 Vercel Token:
npx vercel --token YOUR_VERCEL_TOKEN --prod --yes
获取 Token:
- 访问 https://vercel.com/account/tokens
- 创建新的 Token
- 复制 Token 并在上面命令中替换
YOUR_VERCEL_TOKEN
后续步骤
部署成功后:
- Vercel 会提供一个生产环境 URL(如:mysite-xxx.vercel.app)
- 你可以在 Vercel Dashboard 中配置自定义域名
- 每次 push 到 GitHub 主分支,Vercel 会自动重新部署
自定义域名配置
在 Vercel Dashboard 中:
- 进入项目设置
- 点击 “Domains”
- 添加你的域名:
heyiping.cn - 按照提示配置 DNS 记录
环境变量(如需要)
如果需要设置环境变量:
npx vercel env add VARIABLE_NAME
或在 Vercel Dashboard 的项目设置中添加。
本地开发
npx vercel dev
查看部署状态
npx vercel ls
注意事项
- 确保 Ruby 和 Bundler 在 Vercel 构建环境中可用(已在 vercel.json 配置)
- Jekyll 构建输出在
_site目录 - Vercel 会缓存构建结果以加快部署速度