1.前言

​ 在hexo和hugo中选了很久，最后还是看中了hexo的主题多样性，结果最后选了一个类似hugo的主题（大雾）

​ 谨此以这篇文章记录一下自己搭建的过程吧，顺便留下一篇算不上教程的教程？

​ 以下全过程适用于Windows

2.准备工作（包括注册GitHub）

2.1安装Node.js

​ 下载Node.js

​ 推荐选用长期支持版，安装过程全部默认下一步

​ 安装完成之后，打开命令提示符，输入 node --version 来检查所安装的版本，如果与刚刚所安装的版本一致，说明安装成功

安装好Node.js后默认已安装npm

可选：由于npm在国内速度较慢，可考虑换成淘宝镜像源：npm config set registry https://registry.npm.taobao.org

2.2安装Git并注册GitHub

2.2.1下载 Git 并安装

​ 可同时考虑下载安装 VS Code ，当然直接考虑win自带的记事本也是可以的。

2.2.2注册GitHub

​ 注册 GitHub 账号

​ 注意：注册时的英文用户名将成为你可以使用的免费域名前缀。

​ 登录 GitHub。

​ 点击右上角的 + -> New repository 新建仓库。

我这里因为已经有同名仓库，所以提示了重复。

仓库名称务必为 你的用户名.github.io，用户名是英文，大小写无所谓，但建议统一小写。

为什么必须这个作为仓库名？
GitHub Pages 服务的命名规范，同时它也将成为你的专属域名。当然，你也可以购置自己的专属域名并用它来提供内容。

点击 Create repository。

3.Hexo的安装与使用

3.1安装Hexo

Hexo

​ 命令行中输入以下命令：

1
2
3
npm install hexo-cli -g
# 如果安装失败，可能是没有权限，可以尝试头部加上 sudo 重新执行
# sudo npm install hexo-cli -g

​ 选择你想要创建Hexo目录的文件夹（使用cd命令或者打开想要创建hexo目录的文件夹，鼠标右键git bash here）

​ cd命令示例：

1
2
3
# '#' 字符后的文字代表注释，不需要输入
cd D:\Blog\
#cd目录可改成任何你想要创建hexo目录的文件夹目录，支持多级目录

​ 接下来输入以初始化hexo模板文件：

1
2
3
4
5
6
hexo init
#init 后可接你想要新建的文件夹，若不写文件夹名则默认在当前文件夹生成hexo文件
npm install
# 默认安装所有 `package.json` 文件中提到的包
hexo server
# 你也可以缩写成 hexo s

​ server 代表开启本地的 Hexo 服务器，这时可以打开浏览器，在地址栏中输入 localhost:4000 就可以看到本地的网页了。

​ 按 Ctrl + C 中断服务器的运行。

​ 到此为止，Hexo算是基本安装好了

3.2修改Hexo的主题

​ 如果对hexo自带的默认主题不满意，可去hexo官网挑选主题，一般主题都配有相应的配置文档，就不在此赘述了

3.3将本地hexo文件推送到github

3.3.1生成站点的静态文件。

1
2
3
# 如果进行多次生成，为了避免受错误缓存影响，最好使用 hexo clean 先清除一遍。
hexo generate
# 缩写为 hexo g

此时你的文件夹目录下会出现 public 这个文件夹，里面存放的就是你站点的静态文件。

3.3.2发布到GitHub仓库

​ 在将其部署到 GitHub Pages 上之前，可以先建立一个分支。

你的名字.github.io 部署后，GitHub Pages 将默认使用你的 master 分支作为静态文件部署。
所以可以新建一个 source 分支（命名随意）用来存储 Hexo 源代码，master 分支则用来存储部署后的静态文件。

1
git checkout -b source

这时便成功建立了一个 source 分支。

你可以通过 git branch -v 来查看当前有哪些分支，使用 git branch 分支名 来切换到对应的分支。

​ 将本地的仓库与此前在 GitHub 上建立的仓库建立关联。

1
git init # 初始化 Git 仓库，只需要执行一次即可

​ 安装 hexo-deployer-git 插件

1
npm install hexo-deployer-git

​ 在 _config.yml 中配置。

1
2
3
4
5
deploy:
  type: git
  repo: 你此前新建的仓库的链接 # 比如：https://github.com/Louis7904/louis7904.github.io
  branch: master # 默认使用 master 分支
  message: Update Hexo Static Content # 你可以自定义此次部署更新的说明

​ 保存，部署！

第一次可能需要你输入用户名与密码。
密码输入的时候不会出现 ***，但已经输入进去了。

1
hexo deploy

​ 等待完成后，打开网址 https://你的名字.github.io 就能看到你的线上网站了。

使用 https，http 可能无法正常打开。HTTPS 是多了安全加密的 HTTP，Chrome 浏览器已经默认会显示 http 链接为不安全。
为了安全，建议开启强制 https 跳转 项目地址页面 -> Settings -> Options -> GitHub Pages -> Enforce HTTPS。
此时，http 网址会自动重定向到 https

到此为止，一个简单的hexo个人博客就完成了！

部分常用命令：

输入以下命令即可新建 xxx.md 文件。

1
hexo new post xxx

Markdown 基本语法

4.(可选)乱七八糟的设置

4.1备份hexo源码至GitHub

1
2
# 与远程 Git 仓库建立连接，只此一次即可
git remote add origin https://github.com/你的用户名/你的名字.github.io

​ 接下来准备提交，以后每次备份所需要输入这几句命令

1
2
3
4
5
6
7
# 添加到缓存区
git add -A
git commit -m "描述本次所作的改变"
# 推送至远程仓库
git push
# 第一次提交，需设置一下默认提交分支
# git push --set-upstream origin source

4.2将hexo博客搬迁到vercel

​ 由于github的国内访问速度着实令人着急，可以考虑在github上的blog改成使用vercel发布

​ 同样，首先在Vercel注册

​ 注册好之后可以选择 Import Git Repository ， url选择自己的仓库地址，例如：https://github.com/Louis7904/Louis7904.github.io 一直continue（中间可以修改项目地址）到最后deploy ，几十秒后站点就部署完成了

​ 自定义域名： 点击自己的项目 View domains 选择 domains 输入自己拥有的域名 add 完成添加，之后根据提示更改dns并转移dns server

4.3自动部署（等待施工中…）