Win11：Hexo博客搭建 & 部署远端(GitHub) & 更换主题

Hexo简介

Hexo是一款基于Node.js的静态博客框架，依赖少易于安装使用，可以方便的生成静态网页托管在GitHub和Coding上，是搭建博客的首选框架。大家可以进入hexo官网进行详细查看，因为Hexo的创建者是台湾人，对中文的支持很友好，可以选择中文进行查看。

效果展示

搭建步骤

本地

1. 安装Node.js（下载LTS长期支持版）和Git

node -v #检查node是否安装成功
git -v #检查git 是否安装成功

2. 下载安装cnpm

 npm install -g cnpm --registry=http://registry.npm.taobao.org

3. 下载安装Hexo

cnpm install -g hexo-cli 

4. 创建Blog文件夹，初始化Hexo

hexo init Blog

5. 启动本地博客服务，通过http://localhost:4000/访问本地博客

cnpm install
Hexo s

远端

1. 在Github创建一个新的Public（公开）仓库 ，仓库名必须是：GitHub名字.github.io
2. 在Blog目录下安装git部署插件

 cnpm install --save hexo-deployer-git

3. 配置Blog文件夹中的_config.yml 文件
   
4. GitHub全局配置

		git config --global user.email GitHub注册邮箱
		git config --global user.name GitHub名字
		git config --list	#命令来查看是否配置成功

5. 部署 ，通过：https://GitHub名字.github.io/ 查看远端博客

hexo c
hexo g
hexo d	#部署到Github仓库里

6. 切换主题

git clone https://github.com/litten/hexo-theme-yilia.git themes/yilia #下载主题

7. 修改_config.yml 文件中的 ：
   
8. 推远端

hexo c 
hexo g
hexo d

9. 访问https://GitHub名字.github.io/

写博客

  在Hexo博客中，博客内自带一篇文章，对于Hexo博客的讲解。 使用命令hexo new "文档名"，Hexo会创建一个文档.md文件，打开文档文件即可写博客（使用Markdown语法）
 但是在CMD窗口写博客有点不够直观和方便，个人推荐使用Typora软件写好博客，将文件直接放入Blog/source/_posts 再推到GitHub上即可。

报错&注意事项

1. 有安装需求的命令一定要以管理员身份运行终端，否则会报错：“权限不够之类的”

2. 其余命令正常运行终端即可，否则会报错：“禁止运行脚本语言”

3. Hexo的所有命令要在Blog根目录下运行

4. GitHub仓库设置

   • 仓库名必须是：
     GitHub名.github.io
     例如此处我的就是：zhang-mao-sheng.github.io
     部署完成后通过：https://zhang-mao-sheng.github.io/访问自己的博客
   • Description是对仓库进行简介描述
   • 设置为Public公开的仓库

5. Hexo s失败
   在当前目录运行cnpm install（注意要用管理员身份运行终端）

6. YAMLException: can not read a block mapping entry; a multiline key may not be an ······
   此处是修改_config.yml 文件出错，记住符号一定要是全英文且每一个冒号后面要加空格

7. Hexo d 推送远端失败

   • 网络太差连接不上GitHub

   • GitHub全局没有配置

   • 配置_config.yml 文件时，冒号空格有问题或者是中文冒号

   • Git里面设置的是ssh提交，而自己配置_config.yml 文件时设置的是https
     配置_config.yml 的repository的路径是根据GitHub的仓库来决定的

   • _config.yml 文件中的branch配置有问题
     这点是和安装Git时有关系，一般安装Git默认分支branch是master，如果有修改过那分支branch就是main

   • 重复以下步骤：
     hexo c
hexo g
hexo d

   • 重启cmd窗口

   • 删掉blog文件，重新开始

最后

整个流程并不复杂，但是就是会遇到一些稀奇古怪的Bug，在网上有关Hexo博客的问题有很多解决方案
以上总结的报错仅是我部署时所遇到的，如有其他Bug可以在评论区留言，同时此篇文章有问题也欢迎指正。