Hexo搭建Github博客教程

1. 环境配置

（1）安装Git Bash：Windows安装配置Git教程（2023.10.06 Git2.42.0）。

（2）安装NodeJS：NodeJS的安装及配置。

（3）修改npm镜像源：

npm config set registry https://registry.npm.taobao.org
1

（4）安装Hexo：

npm install hexo-cli -g
1

（5）安装部署插件：

npm install hexo-deployer-git --save
1

此处如果出现以下错误需要以管理员身份打开cmd，然后在cmd中安装：

2. 本地博客搭建

首先创建文件夹Hexo，然后进入该文件夹，创建文件夹blog，使用管理员身份打开cmd，进入blog文件夹，初始化Hexo博客：

hexo init
1

然后在本地启动一下看看效果：

hexo s
1

然后打开链接：http://localhost:4000/，之后我们进行页面调试都是在这个本地链接进行的，页面如下：

使用VS Code打开blog文件夹：

其中，source/_posts文件夹下存放我们写的文章，themes文件夹存放博客的主题，_config.yml是博客的全局配置文件，_config.landscape.yml是博客的主题配置文件。

3. 部署至Github

在Github创建一个名为用户名.github.io的仓库：

在VS Code中打开blog文件夹，找到_config.yml文件，找到deploy，按照以下格式进行修改：

deploy:
  type: git
  repo: git@github.com:你的用户名/你的用户名.github.io.git
  branch: master
1
2
3
4

最后执行以下命令：

hexo clean  # 清除缓存
hexo g      # 生成静态网页
hexo d      # 部署到Github，注意需要在Git Bash中部署
1
2
3

然后访问域名：https://用户名.github.io/ 即可进入自己的博客啦。

4. 博客主题设置

Hexo主题官网：Hexo Themes。

将下载好的主题放到blog/themes文件夹中：

然后将根目录下的_config.yml中的主题修改为下载的主题即可，例如：

theme: shoka
1

然后进入主题的文件夹，该文件夹下也有一个_config.yml文件，修改这个文件的内容即可修改当前博客主页的样式。

5. 博客备份

在Github新建一个名为blog的私有仓库：

仓库创建完成后，在Hexo/blog目录下打开Git Bash，执行以下命令：

git init  # 初始化仓库
git add .  # 添加文件到暂存区
git commit -m "initial blog"  # 将暂存区内容添加到仓库
git branch -M main  # 重命名分支为main，和博客的分支master区分开
git remote add origin git@github.com:你的ID/blog.git  # 添加到远程版本库
git push -u origin main  # 提交到Github
1
2
3
4
5
6

如果在执行git add .时出现警告：You've added another git repository inside your current repository.，可以将blog目录中的.deploy_git文件夹删除。