个人博客搭建

环境准备：

1. 安装 git

2. 安装 node.js

3. 最好下载一个代码编辑器（例如：VScode、Sublime Text、notepad++ 等）

一、安装 HEXO

打开 cmd，输入以下命令

npm install hexo-cli -g

报错及解决方法

参考这篇博客，文档的权限进行提升：

(2 条消息) npm 安装报错（npm ERR! code EPERM npm ERR! syscall mkdir npm ERR! path C:\Program Files\nodejs\node_ca…）_晴雷的博客 - CSDN 博客

如果发现，根据博客里面的步骤进行更改时，无法修改某一文档的权限时，根据报错时的提醒，单独修改某一文件夹的权限

二、初始化化文件夹

2.1 选择一个盘，创建一个 blog 文件夹

2.2 通过 cmd 窗口，切换盘符，进入该文件夹

2.3 初始化

在 blog 文件夹下输入以下指令

hexo init

如果出现以下错误

多试几次，网络原因，克隆失败（可以直接开加速器或者挂梯子）

出现 Start blogging with Hexo! 表示初始化成功

三、搭建

3.1 继续输入以下指令

hexo g

cmd 窗口不要关闭

3.2 打开 blog 文件夹下的 public 文件夹，查看是否搭建成功

3.3 点击 index.html 文件，浏览器会显示下图的效果

3.4 在 cmd 窗口继续输入以下指令，复制生成的网址，在本地端口打开页面

hexo s

3.5 查看成功后，按 Ctrl+C 关闭端口

四、安装 git 依赖

在 blog 文件夹目录下，在 cmd 窗口中，继续输入以下指令

npm install hexo-deployer-git --save

五、在 GitHub 上创建 git 仓库

仓库名必须以 github name.github.io 命名

注意：这里的名称一定是你 GitHub 的用户名，不然后面会加载不出页面渲染

六、本地博客上传 GitHub

6.1 修改 - config.yml 文件

以 txt 文本格式打开

将下图中的信息进行替换

deploy:
  type: git
  repository: 你的github地址
  branch: main

6.2 上传

在 blog 文件路径下，在 cmd 窗口中依次输入以下指令

hexo clean
hexo g
hexo d    

运行结果应该如下：（如果第一次使用 git，可能会提示登录一下 GitHub，登录一下就可以了）

七、开启 page 服务

在网页进入 GitHub，打开新建的上传博客的仓库，进行如下设置，打开 page 服务

保存后，等待一会，当出现下图所示后，就可以通过网址访问个人 blog 了

进入显示的页面，效果如下：

如果出现以下情况，请查看仓库名称是否为 GitHub 用户名

八、主题更换

官方主题网址：https://hexo.io/themes/

8.1 Butterfly 主题安装

在 blog 根目录下，在 cmd 窗口中输入下列指令

git clone -b master https://github.com/jerryc127/hexo-theme-butterfly.git themes/butterfly

8.2 应用主题

修改 blog 根目录下的 _config.yml，把主题改为 butterfly：

8.3 安装插件

npm install hexo-renderer-pug hexo-renderer-stylus --save

剩余内容请参考下面这篇博客👇

Butterfly 主题美化：http://haiyong.site/post/22e1d5da.html

九、发布

在 blog 文件夹下，找到 source，然后进入_posts，在该文件夹路径，右键进入 git bash here

在 git bash here 输入下列指令

npm i hexo-deployer-git

继续输入下列指令

hexo new post "新建博客文章名"

hexo cl && hexo g  && hexo s

在本地查看，无误后提交云端

hexo d