Hexo 静态博客的 Vercel 部署

使用 Vercel 免费部署 hexo 静态博客

安装 Hexo

• 参考官方文档 文档 | Hexo
• 理论上只要做好“概述”和“建站”两个步骤就可以了
• 安装主题：见后文

建立 GitHub 远程仓库

• 在 GitHub 中新建一个 repo，名字随意，其他的设置不用改，可以设为私有
• 在账户设置里生成一个 Personal access token，妥善保管。

建立本地 git 仓库，并推送到 GitHub

• 进入 hexo 根目录

# 新建git仓库
git init
git add .
git commit -m "first commit"
git branch -M main

# 连接到github，例子：https://github.com/<用户名>/<仓库名>.git
git remote add origin <你的远程仓库地址>
# 设置储存账号密码，去掉 --global 参数可以只对当前参数保存
git config --global credential.helper store 

git push -u origin main
# 会要求输入账号密码，注意密码是之前生成的Personal access token，而不是 github 账户的密码

使用 vercel 部署

1. 用 GitHub 账户登陆 vercel.com
2. 选择从 GitHub 新增项目，选择刚建立的 repo
3. 会自动识别为 hexo 项目，设置什么都不用改，直接确定就好
4. 然后就可以用 vercel 提供的域名访问了，也可以使用自己的域名
5. 本地的项目有更改的话，git add ., git commit, git push 后 vercel 会自动更新

注意事项

关于主题

• 直接 git clone 和 git submodule add 各有优劣，可以了解后自行选择

git clone -b master https://github.com/jerryc127/hexo-theme-butterfly.git themes/butterfly
# 或者
git submodule add https://github.com/jerryc127/hexo-theme-butterfly.git themes/butterfly

关于文件名

• 如果是从其他地方粘贴过来的 md 文件，记得把文件名里的特殊字符去掉，不然虽然本地能跑起来，在 vercel 上会 404
• 如果是 hexo new 的文件，会发现即使有特殊字符，也会在文件名里被自动去掉（Front-matter 中不受影响），所以可以大胆使用特殊字符