使用Hexo+Github搭建个人博客：详细教程

前言：电脑系统为window 10专业版，64位
相关步骤：
0、安装Node.js（exe方式）出错，解决：
https://blog.csdn.net/qq_35165004/article/details/79624289
1、安装Node.js和配置好Node.js环境，打开cmd命令行，成功界面如下

2、安装Git和配置好Git环境，安装成功的象征就是在电脑上任何位置鼠标右键能够出现如下两个选择
https://blog.csdn.net/dsh789/article/details/109787371

注意：一般出于安全考虑，只有在Git Bash Here中才能进行Git的相关操作。如果需要在cmd命令行里调用Git，那么就要配置电脑的环境变量Path，或者在安装的时候选择use Git from the Windows Command Prompt。这个可有可无，影响不大，成功配置的界面如图

3、Github账户注册和新建项目，(过去方式：项目必须要遵守格式：账户名.github.io)，现在可任意名称，并且需要勾选Add a README file

在建好的项目右侧有个settings按钮，点击它，向下拉到GitHub Pages，选择main和root并保存，刷新后，你会看到那边有个网址，访问它，你将会惊奇的发现该项目已经被部署到网络上，能够通过外网来访问它。

4、安装Hexo，在自己认为合适的地方创个文件夹，我是在D盘建了一个blog文件夹。然后通过命令行进入到该文件夹里面

输入npm install hexo -g，开始安装Hexo，此处可能需要更新npm版本输入
npm install -g npm 如果不起作用，运行npm up

输入hexo -v，检查hexo是否安装成功

输入hexo init，初始化该文件夹（有点漫长的等待。。。）

看到后面的“Start blogging with Hexo！”，激动！
输入npm install，安装所需要的组件

输入hexo g，首次体验Hexo

输入hexo s，开启服务器，访问该网址，正式体验Hexo

问题：假如页面一直无法跳转，那么可能端口被占用了。此时我们ctrl+c停止服务器，接着输入“hexo server -p 端口号”来改变端口号

那么出现如下图就成功了

5、将Hexo与Github page联系起来，设置Git的user name和email（如果是第一次的话）

上图是在其文件夹里面鼠标右键，点击Git Base Here。这里“feng”可以替换成自己的用户名，邮箱可以替换成自己的邮箱
输入cd ~/.ssh，检查是否有.ssh的文件夹

输入ls，列出该文件下的内容。下图说明存在

如果没有，输入ssh-keygen -t rsa -C “9***********@qq.com”(自己的github邮箱)，连续三个回车，生成密钥，最后得到了两个文件：id_rsa和id_rsa.pub（默认存储路径是：C:\Users\Administrator.ssh）。

登录Github，点击头像下的settings，添加ssh

新建一个new ssh key，将id_rsa.pub文件里的内容复制上去

输入ssh -T git@github.com，测试添加ssh是否成功。如果看到Hi后面是你的用户名，就说明成功了

问题：假如ssh-key配置失败，那么只要以下步骤就能完全解决
首先，清除所有的key-pair
ssh-add -D
rm -r ~/.ssh
删除你在github中的public-key
重新生成ssh密钥对
ssh-keygen -t rsa -C "xxx@xxx.com"
接下来正常操作
在github上添加公钥public-key:
1、首先在你的终端运行 xclip -sel c ~/.ssh/id_rsa.pub将公钥内容复制到剪切板
2、在github上添加公钥时，直接复制即可
3、保存
测试：
在终端 ssh -T git@github.com

6、配置Deployment，在其文件夹中，找到_config.yml文件，修改repo值（在末尾）

# Deployment
## Docs: https://hexo.io/docs/one-command-deployment
deploy:
  type: git
  repository: git@github.com:*********（你的github名）/pn.git
  branch: main

repo值是你在github项目里的ssh（右下角）

7、新建一篇博客，在cmd执行命令：hexo new post “博客名”

这时候在文件夹_posts目录下将会看到已经创建的文件

在生成以及部署文章之前，需要安装一个扩展：npm install hexo-deployer-git --save

使用编辑器编好文章，那么就可以使用命令：hexo d -g，生成以及部署了

部署成功后访问你的地址：https://********（你的github名）.github.io/pn/ ， 那么将看到生成的文章

好了，到此为止，最基本的也是最全面的hexo+github搭建博客完结。接下来是进阶的操作

在博客目录下：
hexo cl && hexo g && hexo d

回顾一下主要操作：

PS：相关问题连接
1、hexo 部署到 github 上，css、js 文件加载不出来怎么办
https://blog.csdn.net/weixin_42971942/article/details/88623749
2、图片不显示问题
https://blog.csdn.net/z952957407/article/details/111642548
3、node.js setup wizard ended prematurely 失败解决方法
https://blog.csdn.net/z952957407/article/details/121163755