利用hexo+github部署属于自己的个人博客网站
前情提要：如果你出现了莫名其妙的报错，可能与权限有关，可以以管理员的身份运行git bash或者cmd
本篇博客仅限于利用hexo搭建博客，并且部署到github上面，让自己可以有一个访问的域名，不涉及博客的上传以及博客网站的美化。
当然笔者博客上传和网站美化以后会再写一篇博客进行说明
参考自
【基础篇】hexo博客搭建教程 - huanhao - 博客园
Hexo 博客搭建并部署到 GitHub Pages(2024最新详细版)_github pages上部署hexo-CSDN博客
这两篇博客混着看的，因为有的地方这篇不行另外一篇可以，所以我混着来的，而且有的地方可能版本太老了，就不太对了，笔者就再加上笔者自己的情况供大家参考了
文章目录
1.安装git
这个教程网上有很多，可以自己搜索，也可以看看笔者的
黑马程序员 | Git详细教程笔记 | 使用命令 | 从安装到入土_gitee开源项目《黑马课程验证指南》-CSDN博客
2.安装nodejs
【Node】node.js安装与配置（详细步骤）-CSDN博客
除了这篇文章的内容，还要安装cnpm
在git bash里面执行下面的命令
$ npm install -g cnpm
检查cnpm是否安装成功
执行
$ cnpm -v
如果输出版本号就是安装成功了
3.安装hexo
在git bash或者cmd执行下面的命令安装hexo
$ cnpm install hexo-cli -g
终端执行hexo -version出现 Hexo 版本号，说明安装成功
4.初始化博客（建立本地的网站）
创建一个文件夹myblog，但一定要保证myblog是空的，不创建也行
$ hexo init myblog
cd myblog
npm install
初始化成功显示：
vscode 打开 myblog，项目目录如下：
_config.yml 存放的是博客配置信息， source/_posts 是存放文章的地方。
可能遇到的问题
$ hexo init myblog
INFO Cloning hexo-starter https://github.com/hexojs/hexo-starter.git
fatal: unable to access 'https://github.com/hexojs/hexo-starter.git/': SSL certificate problem: unable to get local issuer certificate
WARN git clone failed. Copying data instead
INFO Install dependencies
INFO Start blogging with Hexo!
如果出现这样的报错和页面
问题核心原因
SSL证书验证失败：Git在克隆GitHub仓库时无法验证其SSL证书有效性，可能由以下原因导致
- 本地Git证书配置缺失或错误（尤其Windows系统）
- 网络环境限制（如国内访问GitHub不稳定）
- 系统时间/时区错误（证书验证依赖准确时间）
解决方法
我查了很多，就这个蛮好用的，可以用用
临时关闭Git的SSL验证（应急方案）
git config --global http.sslVerify false # 关闭验证
hexo init myblog # 执行初始化
git config --global http.sslVerify true # 完成后恢复验证
⚠️ 此方法存在安全风险，仅建议临时使用。
5.预览自己搭建的本地网站
打开终端，进入项目根目录执行：
hexo clean # 清除缓存文件，建议写完文章后执行一次
hexo g # 生成 public 文件夹，写完文章执行
hexo s # 启动 hexo 服务
生成的地址可以去访问到默认的界面，bash这会会卡着，等你按下ctrl+c才会停止，停止后网站也会不可访问
浏览器访问 http://localhost:4000/ 出现下图说明启动成功
6.更换主题
hexo的所有主题都在下面这个地址：
https://hexo.io/themes/
你可能会在这个地址看到很多好看的主题，但是我们要慢慢来，有些主题的配置难度还是很高的
我们要找一个功能齐全，配置简单的主题练练手
就是这个新手入门hexo必备的Next主题
预览效果：https://theme-next.org/
项目地址：https://github.com/theme-next/hexo-theme-next
配置文档：https://theme-next.org/docs/getting-started/
但是笔者用的是butterfly，因为觉得这个好看功能多
https://butterfly.js.org/ 大家可以去看看
如你所见，其实每个主题都会包含这个三个东西
- 预览效果
- 项目地址
- 配置文档
点击主题的图片可以打开预览地址，点击主题的标题可以打开项目地址
配置文档我们需要自己去项目地址找，大多数主题的项目地址都是英文，大家可以开翻译找一下
6.1如何下载主题
方法1
打开主题的项目地址后，点击Clone or download
然后复制https开头的地址
然后在你的博客文件夹下面打开git bash
执行：
git clone 复制的地址 themes/主题名字
如图：
现在给你解释一下这个命令
git clone 代表克隆，后面接上一串下载地址，最后面的themes/next是把文件夹下载到主题目录下，并把主题文件命名为next
方法2（推荐）
如果你觉得比较麻烦，还有第二个办法
打开主题项目地址，然后点击Clone or download，然后点击Download ZIP
这样可以下载主题文件压缩包，前提是你已经登入了github（没有账号的，请自己注册一下）
然后解压压缩包，把文件夹放在博客目录下的themes目录，并把文件夹命名为主题的名字
6.2修改配置文件
在博客目录下创建 _config.butterfly.yml，其实是创建 _config.你下载的主题名.yml
将 butterfly 主题的 _config.yml 内容复制进去(打开链接复制)，就是这个页面里面的_conffig.yml
后续修改博客的配置，例如标题，头像，评论等等只需要在 _config.fluid.yml文件中配置就行
6.3预览主题
在博客目录打开git bash
执行
hexo clean
hexo g
hexo s
还是会出现一段浏览地址，我们在浏览器打开就行了
注意：有些主题你更换之后是暂时无法预览的，因为有的主题还需要安装它需要的依赖，这一般都会在主题的文档里面提到，只有安装它的依赖之后才可以正常预览，这里暂时不做说明，会在hexo教程进阶篇说到
7.把博客部署到github上面去
现在我们的博客都是只能本地预览，如何将我们的上传到一个地方，然后通过域名访问呢？
你可能觉得需要一个服务器再买个域名绑定，我可以告诉你都不需要
下面介绍两种部署方法
先来个对比
github：
- 国外网站，是英文
- 访问速度较慢
- 不需要实名认证
- 域名形式可以自定义
coding：
- 国内的平台，网站是中文
- 访问速度快
- 部署网站需要实名认证，只需要填写身份证号即可
- 域名是随机给的，所以很长而且不能自定义
如果你有自己的域名，github和coding都可以绑定域名
笔者推荐github，因为笔者没用过coding网站
1.coding
https://coding.net/user
注册一个coding的账号，这里不做演示
然后按照图片新建一个项目
选择devops
填入相关信息，记得勾选**启用README.cd文件初始化项目**
然后完成创建
我们暂时不能直接上传，需要进行一些配置，如下：
接下来需要我们创建一个git秘钥
打开git bash（不要求在哪个目录）
执行： “这里面是你的邮箱”
不管出现什么信息，你只需要回车就可以了
$ ssh-keygen -t rsa -C “your_email@youremail.com“
然后执行
$ cat ~/.ssh/id_rsa.pub
会输出你的秘钥，我们复制输出信息就行了
然后点击头像，打开个人设置–选择SSH公钥–新增公钥
然后将你复制的秘钥粘贴进去，记得勾选永久有效
然后打开git bash
执行：
$ ssh -T git@git.coding.net
会提示你下面这个，输入yes回车就行了
Are you sure you want to continue connecting (yes/no/[fingerprint])?
接下来打开你的项目选择SSH，然后复制右边git开头的地址
打开站点配置文件
修改deploy信息
deploy:
type: git
repo: 你复制的地址
branch: master
例如：
在博客根目录下打开git bash
分别执行下面的命令：
yourname是你的名字
youremail是你的邮箱
$ git config --global user.name "yourname"
$ git config --global user.email "youremail"
然后安装上传插件
cnpm install hexo-deployer-git --save
上传
以上的配置完成之后，就可以上传了
在博客根目录下打开git bash，执行下面的命令就可以上传了
hexo g -d
然后打开项目，打开构建与部署–静态网站–立即发布静态网站
注意：coding需要实名认证，只需要你输入身份证号就可以了，不用担心泄露隐私，因为coding现在是腾讯的
我们只要填写网站名称就行了，然后保存
因为是刚构建的网站，所以要手动部署一下，以后上传就不需要手动部署
然后访问所给的地址，那个就是我们网站的地址了
之后每次修改完博客要上传的时候，只需执行上传命令
2.github部署（推荐）
你还可以使用github部署你的博客
这里不演示如何注册账号
创建一个仓库
仓库名必须是用户名 + .github.io
然后勾选初始化README
我们暂时不能直接上传，需要进行一些配置，如下：
接下来需要我们创建一个git秘钥
打开git bash（不要求在哪个目录）
执行： “这里面是你的邮箱”
不管出现什么信息，你只需要回车就可以了
$ ssh-keygen -t rsa -C “your_email@youremail.com“
然后执行
$ cat ~/.ssh/id_rsa.pub
会输出你的秘钥，我们复制输出信息就行了
然后点击头像，点击Settings–SSH·····–New SSH Key
粘贴你复制的秘钥，title应该可以随便写，笔者写的myblog
然后打开git bash
执行：
$ ssh -T git@github.com
会提示你下面这个，输入yes回车就行了
Are you sure you want to continue connecting (yes/no/[fingerprint])?
打开项目，点击绿色按钮，点击Use SSH
复制git开头的地址
打开站点配置文件，点击总的_config.yml，不要去你自己的那个_config.butterfly.yml
修改deploy信息
deploy:
type: git
repo: 你复制的地址
branch: master
例如：
在博客根目录下打开git bash
分别执行下面的命令：
yourname是你的名字
youremail是你的邮箱
$ git config --global user.name "yourname"
$ git config --global user.email "youremail"
然后安装上传插件
cnpm install hexo-deployer-git --save
部署到github上面
以上的配置完成之后，就可以部署了
在博客根目录下打开git bash，执行下面的命令就可以部署了
hexo g -d
3.得到自己的网址
原作者的操作
然后打开项目，点击Settings
往下滑找到Github pages
点击none 选择master branch
之后你会得到一个地址，这个就是你的网站地址了
笔者的操作
笔者默认的分支就是master，所以不需要改动，执行完hexo g -d就直接有了下面的网址
先点击左侧pages
然后出现以下页面
主要是要出现这个
就是咱们自己的网址
笔者的就是https://darling-123456.github.io/
看看效果
至于美化和上传博客，等我学会了会再写一篇博客教大家，也不会太久，大概就在本周之内解决吧
教程到此结束