Hexo + Github搭建个人博客

一、环境搭建

在安装Hexo之前，需要先把环境搭建好，首先下载Git和Node.js，下载好最新版本进行安装，安装过程中一路默认就可以了，如果有需要也可以自定义安装路径。

安装完成之后，在桌面空白处右键鼠标，点击Git Bash Here，分别输入以下命令并回车：node -v、npm -v和git --version，出现版本号即说明安装成功。

123@DESKTO ~/Desktop
$ node -v
v16.13.0

123@DESKTOP ~/Desktop
$ npm -v
8.1.0

123@DESKTOP ~/Desktop
$ git --version
git version 2.33.1.windows.1

二、配置Github

1、登录Github

首先登录你的Github，如果没Github账号的话请先注册一个账号并登录，关于Github的访问问题，网上有很多教程，就不多赘述了，登录之后进行下一步。

2、配置密匙

在桌面右键鼠标，点击Git Bash Here，输入以下命令并回车（双引号内的内容，按自己的账号进行填写）：

git config --global user.name "GitHub 用户名"

git config --global user.email "GitHub 邮箱"

输入ssh-keygen -t rsa -C "GitHub 邮箱"，然后一路回车。

打开此电脑，进入C盘-Users-用户名-.ssh，在.ssh文件夹里（要勾选显示“隐藏的项目”），用记事本打开 id_rsa.pub 文件并复制里面的内容等会儿要用到。

打开刚刚登录的Github，在主页点击右上角的头像-点击Settings，进入Settings页面，在左侧的内容栏中找到并点击SSH and GPG keys，点击 New SSH key，Title这一栏随便填写，把刚刚从id_rsa.pub文件里复制的内容，粘贴到Key里，然后点击Add SHH Key。

打开Git Bash Here，输入ssh -T git@github.com并回车，出现“Are you sure……”，输入 yes 并回车。

显示 “Hi xxx! You’ve successfully……” 即连接成功。

3、创建 Github Pages 仓库

在Github主页，点击右上角的+号，在弹出的列表里，点击New repository，在Repository name 中输入 用户名.github.io，Description 选填，选择Public，在Initialize this repository with里:勾选Add a README file。

填好后点击 Create repository 创建。

创建后默认自动启用 HTTPS，博客地址为：https://用户名.github.io

三、安装Hexo

首先新建一个文件夹，路径和文件名最好是全英文，新建之后打开该文件夹，右键鼠标，点击Git Bash Here，输入以下命令安装Hexo：

npm install -g hexo-cli

因为一些总所周知的原因，导致下载很慢甚至下载安装失败，这时候可以考虑把源换成淘宝源，输入以下命令：

npm config set registry https://registry.npm.taobao.org
npm config get registry

设置成淘宝源之后，使用cnpm命令安装Hexo：

cnpm install -g hexo-cli

换源之后，下载速度很快，十几秒就下载并安装好了。

然后依次输入以下命令：

hexo init      # 初始化
npm install    # 安装组件

完成后分别输入以下命令：

hexo g   # 生成页面
hexo s   # 启动本地预览

当运行hexo s成功之后，用浏览器访问http://localhost:4000，会出现Hexo默认页面，说明博客大致已经搭建好了，只剩下最后一步，把它部署到Github上。

预览完之后，在打开的Git Bash Here窗口里，按下ctrl+c就会退出hexo s了。

四、部署Hexo到Github Pages

首先安装 hexo-deployer-git插件：

npm install hexo-deployer-git --save #部署推送

然后在你博客的根目录下找到配置文件**_config.yml**，打开它：

在内容的最后面找到Deployment这一段，把下面的内容修改成如下：

deploy:
  type: git
  repository: https://github.com/Github用户名/Github用户名.github.io.git
  branch: main #根据自己的Github设置来更改是main还是master

修改完成后，保存并退出，然后运行hexo d，将博客部署到Github Pages。

在执行hexo d的时候，可能会弹出一个窗口，让你登录Github账号进行认证，自行选择认证方式即可，认证完成即可完成部署，我选择的是输入Token，具体步骤如下：

在Github主页，点击右上角的+号，在弹出的列表里，点击Settings —> developer settings —> personal access tokens —> generate new token —> Note：输入任意名称 —-> Expiration：选择授权时长 —> 然后勾选repo —> 最后点击Generate Token完成设置，然后复制一下Token的值，在弹出的窗口里，选择Token，把刚刚复制的东西粘贴进去就行了。

​

这一步如果不出意外的话，博客已经成功部署到Github Pages了，这时候打开浏览器，访问https://Github用户名.github.io，就能线上访问你的博客了。

本文章在搭建过程中遇到一些问题，网上找到的教程或多或少和现在最新的搭建情况有点不符合了，所以有了这篇文章，记录一下搭建过程，如果一切顺利的话，整个流程不会超过10分钟。

本文章参考以下文章：

使用 Hexo+GitHub 搭建个人免费博客教程（小白向） - 知乎 (zhihu.com)

Hexo的详细搭建过程——小白的血泪经历QAQ - 橘崽崽啊 - 博客园 (cnblogs.com)

github的token使用方法_chengwenyang的专栏-CSDN博客_github token

打赏