我的第一篇博客

跟着网上的教程尝试了一下搭建个人的 blog，你别说其实还挺简单的，所以记录一下第一次搭建博客的过程

搭建准备

需要用到的工具有

Nodejs

vscode

GitHub

git

现在确保你已经拥有了以上几个工具（vscode 可用其他的代码工具代替）

Nodejs 环境的配置

听我的，直接去网上找一篇 nodejs 的下载安装指南，马上就可以入门，或者看我的教程。

首先先确保已经下载了 LTS 版本的 nodejs，双击下载到本地的安装包开始安装，中间不需要点击任何位置，全部默认。

安装路径可以改成别的地方，比如在 D 盘创建一个新文件夹 nodejs 除非你是 c 盘战士。

安装后，快捷键 win+r 在跳出的窗口输入 cmd
在 cmd 中键入 node -v 和 npm -v 确定你安装成功了，你也可以打 where node / where npm 来知道这两个东西安装到哪里了

  1. 找到你安装 node 的路径，把那个你自己起名的文件夹（我起的名字是 nodejs）右键选择 属性–>安全–>高级–>更改权限
    将你所在的用户权限改为“完全控制”即可，这样你不至于每次安装都得开管理员模式，并且也不容易报错

  2. 在你 windows 左下角的搜索框搜索编辑系统环境变量，随后在那个页面点击环境变量，里面分为上下两个部分 用户变量/系统变量
    我们需要创建以下环境变量：
    用户变量 1 path 中修改 AppData\Roaming\npm 为 [nodejs 的安装路径]\node_global
    系统变量 1 新建变量 NODE_HOME : [nodejs 的安装路径]
    系统变量 2 新建变量 NODE_PATH : [nodejs 的安装路径]\node_global\node_modules
    系统变量 3 Path 中新建变量 %NODE_HOME%
    系统变量 4 Path 中新建变量 %NODE_PATH%

    然后回去到[nodejs 的安装路径]中新建以下两个文件夹：【node_global】和【node_cache】

  3. 创建完毕后，将你默认路径下的 node_modules 和除了 installtool 和 nodevar.bat node.exe 之外的东西一并复制到你的 node_global 文件夹中

  4. 使用管理员身份打开 cmd 命令窗口，输入

    ①npm config set prefix “[nodejs 的安装路径]\node_global” （复制你刚刚创建的“node_global”文件夹路径）

    ②npm config set cache “[nodejs 的安装路径]\node_cache” （复制你刚刚创建的“node_cache”文件夹路径）

    注意千万不要输错了 nodejs 的安装路径了，而且不要把[ ]打进去，这里的[ ]只是演示作用的

现在再次在 cmd 中键入 node -v npm -v where node where npm 来验证一下环境配置是否正确，如果错误的话，会提示你 npm/node 不是本地指令

git 的安装比较的简单，直接安装就可以了，这里就不拆分出来了，如果有困难的话，可以看这里

搭建 HEXO 框架

接下来我们要开始正式构建了

我们首先先打开 cmd，打入代码 npm install -g hexo-cli 这将为你全局安装 hexo ，安装完成后输入 hexo -v 来确认你安装成功了

随后我们创建一个空的文件夹，名字可以叫 blog，也可以是其他什么, 在 vscode 中打开这个文件夹作为工作区，点击菜单栏的终端，终端选择 cmd(Command Prompt)终端（不推荐用 gitbash，也不推荐用 Powershell，问就是报错过）

在这个文件夹的终端下面，输入 hexo init 等待框架构建完成

注意，如果你的 hexo 没安装成功，或者环境配置错误，这里会可能报错

随后输入 hexo n "你的博客名字" 用于创建一篇 md 格式的博客

输入 hexo s 启动本地服务，接下来你会在 http://localhost:4000/ 中看到你的本地博客服务啦

上传 Github 仓库

很显然，我们的博客仅仅在本地跑起来并没有什么用，下一步我们将选择 github 作为服务器搭载我们的博客

至于为什么选择 Github，那是因为他免费啊（直球）

如果你愿意选择其他的服务器，那么首先你要学会在服务器上部署这些内容，学会 linux(或者用宝塔安装)，然后享受每个月高额的租金，实在是太麻烦了，还是用 github 吧

毕竟我们只是新手入门搭建而已···

首先你得有 github 的账号，如果没有那就去注册一个

在你的账号里选择创建新仓库 Create a new repository 并且给仓库命名为 [你的用户名].github.io

注意一定要按照这个规范来创建新仓库！

如果你用的是 vscode，那么恭喜你，你可以不需要什么 ssh 秘钥，因为在 vscode 上登录 github 账号，你就可以直接免去输入账号密码的困难。

如果你不是，那么你最好还是进入任意文件夹，右键空白处然后点 Git bash here,输入

``ssh-keygen -t rsa -C “邮件地址” ` 敲 4 次 Enter

然后进入 C:\Users\用户名，在里面进入.ssh 文件，用记事本打开里面的 id_rsa.pub,全选复制里面的代码

打开 github，进入用户设置，找到 SSH keys

新建 SSH keys，名称随意，在下面粘贴代码，

在 git bash 中输入

ssh -T git@github.com 验证是否成功

回车，然后再输入 yes

然后我们打开先前搭好的 blog 框架，找到_config.yml 直接在 vscode 中打开，拉到最底下

将 deploy 后面改为 

1
2
3
type: git
repository:
branch: main

不要删掉空格，type 前面有两个空格，冒号后面还有一个空格

在你的 github 上的空仓库中，点击 code，找到旁边的 http 链接，复制到 repository:的后面，保存下来

继续在 cmd(或者其他终端)上操作

输入 npm install hexo-deployer-git --save

随后键入

hexo g（生成）

hexo d（上传）

如果一切顺利的话，接下来你打开 [你的用户名].github.io 这个网址，你就可以看见自己的博客啦！

但是因为 github 在国内速度非常慢的原因，你可能需要开加速器，或者是其他的什么工具方便你访问自己的博客主页，现在祝你使用愉快~

可能对你有帮助的的链接

1.Typora（用于编写 md 文件）

2.更优秀的博客搭建教程 / 更优秀的博客教程 2

3.Hexo 适用的好看主题Butterfly，我用的也是这个

4.md 的编写规则（博客使用 md 编写）

5.Nodejs 下载链接

6.Git 下载链接

7.Vscode 下载链接

8.Github Action 实现自动部署

9.Butterfly 官方指南