Hexo+GitHub 博客部署 个人踩坑记录（一）

Hexo+GitHub 博客部署 个人踩坑记录（一）

---

前言

• 博客的作用

编程学习本身是持续性的学习行为，说明所学习的内容是在持续地增加。这要求我们要学会阶段性总结自己所学的东西，复习并巩固。所以写文章，尤其写博客文章有助于我们提高自身水平。在博客编写的过程中，我们可以去锻炼自己思考能力、总结能力、文笔组织能力、逻辑思维能力。这属于长期收益行为，短期内无法看到成效的。
尤其是文笔能力，在踏入社会进行工作后，公司经常会有周报、技术文档、代码帮助文档之类的文本文档要完成，良好的文笔有利于团队之间的沟通和合作。

局部知识学完了要去总结，单个知识点学完了要去总结。一个章节学完了要去总结回顾，整体学完了要去整体总结，梳理思路，建构起整体的系统结构。
另外，博客可以记录自己经常性和特殊性的代码错误，起到示警作用。

以上是博客的作用，下面，在经历多种方法对比和选择之后，我决定以 Hexo+GitHub 的方式来进行博客部署。此文主要内容为我在部署过程中的踩坑记录，并非教程。

希望能给你带来帮助

---

阅读须知

• 本篇文章是在基于 Hexo+Github博客搭建完全教程 | 洪卫の博客 (sunhwee.com) 此链接的教程进行博客搭建。对于此博文以及下文中所引用的所有连接表示感谢.
• 下文主要内容是对于本人在按照教程进行的时候遭遇的相关问题，即踩坑之后个人的解决方法，部分内容会给出相关的引用。
• 部署环境(本文撰写时间)：Window 10 |git version 2.30.1.windows.1| hexo-cli: 4.2.0

---

安装步骤

前置准备：注册GitHub账号、VPN（非必须）

• 1.安装Git
• 2.安装Node.js
• 3.安装Hexo
• 4.GitHub创建个人仓库
• 5.生成SSH添加到GitHub
• 6.将hexo部署到GitHub
• 8.发布文章

---

踩坑记录

问题一

在安装hexo框架时npm指令不成功

npm install hexo-cli -g
bash: npm: command not found

• 原因

搜索浏览后，此博文 给出的方案提出是安装路径配置和环境变量的问题。回溯到上一步，可见教程对于node.js安装时的路径配置时设置为默认的。

对于此问题，文章中也给出解释说明：

一般情况下，我们安装Node.js环境，程序会自动把NPM全局模块的路径设置在系统盘（通常是C盘下），我们在项目开发阶段不建议全局路径设置在系统盘，不但会影响电脑的性能，而且还很不安全。而且在后期开发过程中需要用到脚手架工具，使用NPM默认安装的路径在C盘，目录层级很深，也没有配置环境变量，所以在运行类似于vue的命令时会出现 “不是内部或外部命令” 的提示 。

原文链接：https://blog.csdn.net/p445098355/article/details/104525919

• 解决方法建议

1. 重新进行node.js 安装，在安装过程中自定义路径。并将所安装的路径记住，在后面的环境变量配置中进行配置.
2. 修改NPM全局模式的默认安装路径,按照此链接（点击这里）说明进行配置。注意,设置路径为你本地安装的路径。

引用连接：

修改NPM全局模式的默认安装路径_柯晓楠-CSDN博客_npm 全局安装路径

【hexo+github搭建myblog】bash: npm: command not found 问题，疑似解决！关键词：NPM全局安装路径 - jane_panyiyun - 博客园 (cnblogs.com)

问题二

添加国内镜像链接，未配置成功

添加镜像连接时候，注意字母单词的拼写。set和get两者不同：

npm config set  registry  http:/.....     #赋值
npm config get  registry  #查询

问题三

hexo -v 命令不成功

hexo -v
bash: hexo: command not found

• 原因

和问题一相同，仍然是环境变量配置问题。

此处给出定义：

环境变量是在操作系统中一个具有特定名字的对象，它包含了一个或者多个应用程序所将使用到的信息。例如Windows和DOS操作系统中的path环境变量，当要求系统运行一个程序而没有告诉它程序所在的完整路径时，系统除了在当前目录下面寻找此程序外，还应到path中指定的路径去找。用户通过设置环境变量，来更好的运行进程。
环境变量一般是指在操作系统中用来指定操作系统运行环境的一些参数，比如临时文件夹位置和系统文件夹位置等。
————————————————

• 解决方法

hexo博客出现command not found解决方案_Just do it !-CSDN博客

问题四

设置本地GitHub用户名和邮箱，检查时发现输入不符

git config --global user.name "yourname"
git config --global user.email "youremail"

解决建议

1. 检查在命令输入时 user.name和"yourname"中间是否用空格隔开。（没有用空格隔开是是无效的命令）

2. 设置了隐私邮箱，去GitHub上自主修改

setting-Emails-Keep my email addredd private去掉勾选。

问题五

创建SSH密钥 具体步骤

GitHub博客hexo建站之设置SSH 密钥（keys） - xinxiandong - 博客园 (cnblogs.com)

问题六

教程中 创建ssh ，一路回车。指的是跳过密钥密码设置过程，如果你觉得不安全可以设置密钥。

如果你像我一样在ssh设置的过程中设置了密钥密码，当出现如下图示

Enter passphrase for key '/c/Users/游遥/.ssh/id_rsa':

请将之前设置的密钥密码输入进去即可

参考连接

The authenticity of host ‘github.com (13.229.188.59)’ can’t be established. - JavaShuo

GitHub博客hexo建站之设置SSH 密钥（keys） - xinxiandong - 博客园 (cnblogs.com)

问题七

打开yml文件的方式

解决方案：用任意编辑器或IDE打开。（不推荐用便签和word）

问题八

关联hexo和GitHub，将hexo生成的文章部署到GitHub上。

此处需要博客yml文件进行配置，在博客根目录下的_config.yml文件，这是博客的配置文件，在这里你可以修改与博客配置相关的各种信息。

此处注意，GitHub在最近时间将创建仓库的默认分支名更改为main,此文教程在Hexo部署到GitHub时 _config.yml 配置时branch 应更改为为main

网上大多数教程大都以master做默认分支，进行hexo d 导致提交时提交至master分支而非main分支。默认分支同时也为活跃分支，分支错误会导致托管在其上的内容未变。

关于hexo更新到GitHub后博客内容未变问题_Lu_xiuyuan的博客-CSDN博客

gitHub把master分支换成main,你知道了么？ - 【程序员】 (toutiaoweb.com)

问题九

将博客部署上线的主要命令

hexo c # clean 清除缓存文件
hexo g # generate 生成静态文件
hexo s # server 启动服务器
#访问给予的链接查看 没问题后提交
hexo d # deploy 部署网站

Hexo、主题、部署上线_MoYu’s Blog-CSDN博客

其他

• 关于维护

Hexo+Github搭建个人博客两个分支方便维护]

• 其他参考连接

hexo+github搭建个人博客教程和各种坑_cuteerha的博客-CSDN博客

hexo githubpage 初始化 并解决同步静态页面问题_weixin_34295316的博客-CSDN博客

使用hexo+github搭建免费个人博客详细教程 - 我是小茗同学 - 博客园 (cnblogs.com)

【Hexo搭建独立博客全纪录】（一）使用Git和Github - 简书 (jianshu.com)

---