Hexo个人博客安装及配置

Glensea

已于 2022-06-15 19:22:18 修改

阅读量479

点赞数 1

文章标签： git github npm

于 2022-05-25 15:37:38 首次发布

本文链接：https://blog.youkuaiyun.com/sparkstark/article/details/124967315

版权

本文详细介绍如何使用Hexo搭建个人博客，包括安装Git、Node.js、Hexo等步骤，并指导如何部署到GitHub以及设置个人域名。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

Hexo个人博客安装及配置

Hexo简介

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

Hexo搭建

1. 安装Git

Git是目前世界上最先进的分布式版本控制系统，可以有效、高速的处理从很小到非常大的项目版本管理。也就是用来管理你的hexo博客文章，上传到GitHub的工具。Git非常强大，我觉得建议每个人都去了解一下。糖葫芦的小黑屋的Git教程写的非常好，大家可以了解一下。Git教程

windows：到git官网上下载,Download git,下载后会有一个Git Bash的命令行工具，以后就用这个工具来使用git。

linux：对linux来说实在是太简单了，因为最早的git就是在linux上编写的，只需要一行代码

sudo apt-get install git

安装好后，用 git --version 来查看一下版本

2. 安装nodejs

Hexo是基于nodeJS编写的，所以需要安装一下nodeJs和里面的npm工具。node.js安装及环境配置

windows：nodejs选择LTS版本就行了。

linux：

sudo apt-get install nodejs
sudo apt-get install npm

安装完后，打开命令行

node -v
npm -v

检查一下有没有安装成功

顺便说一下，windows在git安装完后，就可以直接使用_git bash_来敲命令行了，不用自带的cmd，cmd有点难用。

3. 安装hexo

前面git和nodejs安装好后，就可以安装hexo了，你可以先创建一个文件夹blog，然后cd到这个文件夹下（或者在这个文件夹下直接右键git bash打开）。

输入命令

npm install -g hexo-cli

依旧用hexo -v查看一下版本

至此就全部安装完了。

接下来初始化一下hexo

hexo init myblog

这个myblog可以自己取什么名字都行，然后

cd myblog //进入这个myblog文件夹
npm install

新建完成后，指定文件夹目录下有：

node_modules: 依赖包

public：存放生成的页面

scaffolds：生成文章的一些模板

source：用来存放你的文章

themes：主题

_config.yml: 博客的配置文件

hexo g
hexo server #可简写为：hexo s

改变本地运行端口：

hexo s -p8080 #8080为端口号

打开hexo的服务，在浏览器输入localhost:4000就可以看到你生成的博客了。

使用ctrl+c可以把服务关掉。

4. GitHub创建个人仓库

首先，你先要有一个GitHub账户，去注册一个吧。

注册完登录后，在GitHub.com中看到一个New repository，新建仓库

创建一个和你用户名相同的仓库，后面加.github.io，只有这样，将来要部署到GitHub page的时候，才会被识别，也就是xxxx.github.io，其中xxx就是你注册GitHub的用户名。我这里是已经建过了。

点击create repository。

5. 生成SSH添加到GitHub

回到你的git bash中，

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

这里的yourname输入你的GitHub用户名，youremail输入你GitHub的邮箱。这样GitHub才能知道你是不是对应它的账户。

可以用以下两条，检查一下你有没有输对

git config user.name
git config user.email

然后创建SSH,一路回车

ssh-keygen -t rsa -C "youremail"

这个时候它会告诉你已经生成了.ssh的文件夹。在你的电脑中找到这个文件夹。

ssh，简单来讲，就是一个秘钥，其中， id_rsa 是你这台电脑的私人秘钥，不能给别人看的， id_rsa.pub 是公共秘钥，可以随便给别人看。把这个公钥放在GitHub上，这样当你链接GitHub自己的账户时，它就会根据公钥匹配你的私钥，当能够相互匹配时，才能够顺利的通过git上传你的文件到GitHub上。

而后在GitHub的setting中，找到 SSH keys 的设置选项，点击 New SSH key
把你的id_rsa.pub里面的信息复制进去。

在gitbash中，查看是否成功

ssh -T git@github.com

可能遇到的问题

报错：

s://github.com/user_name/user_repo.git  
fatal: remote error:  
	You can't push to git://github.com/user_name/user_repo.git  
	Use http

win+R打开cmd控制台，输入下面代码

cd C:\Users\Fang\.ssh
git init
git remote add origin git@github.com:user_name/user_repo.git

注解：
user_name：github用户名
user_repo：存储库名

6. 将hexo部署到GitHub

这一步，我们就可以将hexo和GitHub关联起来，也就是将hexo生成的文章部署到GitHub上，打开站点配置文件 _config.yml ，翻到最后，修改为
YourgithubName就是你的GitHub账户

deploy:
  type: git
  repo: https://github.com/YourgithubName/YourgithubName.github.io.git
  branch: master

这个时候需要先安装deploy-git ，也就是部署的命令,这样你才能用命令部署到GitHub。

npm install hexo-deployer-git --save

然后

hexo clean
hexo generate #可简写为：hexo g
hexo deploy #可简写为：hexo d

其中 hexo clean 清除了你之前生成的东西，也可以不加。
hexo generate 顾名思义，生成静态文章，可以用 hexo g缩写
hexo deploy 部署文章，可以用 hexo d 缩写

注意deploy时可能要你输入username和password。

得到下图就说明部署成功了，过一会儿就可以在 http://yourname.github.io 这个网站看到你的博客了！！

可能遇到的问题

问题一

解决方法：

删除hexo（例：前面创建的myblog）目录下的 .deploy_git 文件夹

执行：

git config --global core.autocrlf false
hexo clean
hexo g
hexo d

问题二

解决方法：

将hexo（例：前面创建的myblog）目录下的配置文件 _config.yml 中

deploy:
  type: git
  repo: https://github.com/YourgithubName/YourgithubName.github.io.git
  branch: master

改为：

deploy:
  type: git
  repo: git@github.com:YourgithubName/YourgithubName.github.io.git
  branch: master

问题三

解决方法：

可能因为你连接的WIFI拦截了，换成个人的手机热点即可。

7. 设置个人域名

现在你的个人网站的地址是 yourname.github.io，如果觉得这个网址逼格不太够，这就需要你设置个人域名了。但是需要花钱。

注册一个华为云（腾讯云，阿里云）账户，在华为云上买一个域名，我买的是 glensea.cn，各个后缀的价格不太一样，比如最广泛的.com就比较贵，看个人喜好咯。

你需要先去进行实名认证,然后在域名控制台中，看到你购买的域名。

点解析进去，添加解析。

其中，192.30.252.153 和 192.30.252.154 是GitHub的服务器地址。(服务器地址可以通过：ping yourname.github.io)

注意，解析线路选择默认 ，不要像我一样选境外。这个境外是后面来做国内外分流用的,在后面的博客中会讲到。记得现在选择默认！！

登录GitHub，进入 之前创建的仓库 ，点击settings，设置Custom domain，输入你的域名 glensea.cn

然后在你的博客文件source中创建一个名为CNAME文件，不要后缀。写上你的域名。没有该文件每次 hexo d 都会重置你的 Custom domain

最后，在gitbash中，输入

hexo clean
hexo g
hexo d

过不了多久，再打开你的浏览器，输入你自己的域名，就可以看到搭建的网站啦！

接下来你就可以正式开始写文章了。

hexo new newpapername

然后在source/_post中打开markdown文件，就可以开始编辑了。当你写完的时候，再

hexo clean
hexo g
hexo d

就可以看到更新了。

更换主题

到这一步，如果你觉得默认的landscape主题不好看，那么可以在官网的主题中，选择你喜欢的一个主题进行修改就可以啦。点这里

这里有200多个主题可以选。不过最受欢迎的就是那么几个，比如NexT主题，非常的简洁好看，大多数人都选择这个，关于这个的教程也比较多。这个博客用的是keep这个主题，配套文档很齐全，简约大方。

keep主题在线预览

参考文献

https://blog.youkuaiyun.com/sinat_37781304/article/details/82729029
https://blog.youkuaiyun.com/qq_24135817/article/details/79830630
https://blog.youkuaiyun.com/qq_48759664/article/details/119480266
//xpoet.cn/)**