Hexo 博客与你 ——如何利用 GitHub 与 Hexo 搭建你的个人博客
前言
如果你还在忍受诸如新浪微博、腾讯微博等博客网站的臃肿，那你马上该读一读这篇文章了。
拥有一个你自己的博客网站，你可以：
- 记录日常生活⏰
- 写写学习笔记📋
- 跟其他博客创作者们探讨写作🖊
- 发电⚡
至于为什么写博客，上知乎搜一搜就有很多答案。我的语文老师说过一段话，我觉得很适合回答这个问题：
作文（划掉）博客是孩子们的一种创造，是一种优秀的表现，古人曾经靠的是一篇文章走遍天下。而如今，能写得一手好文章，也会受益终生。谢谢。
那不多废话，往下读开始你的博客生涯吧。
准备工作
在开始之前，你应该：
- 有一台能访问互联网的，能正常工作的电脑。
- 会使用搜索引擎。知道常用计算机术语并至少有初中的英语水平。
- 会基础的文件操作。如复制、粘贴、下载和上传。
- 有一个能正常使用的电子邮箱。如 QQ 邮箱。
另外，我非常建议使用加速器和 VPN。因为 GitHub 在中国没有服务器，使用 VPN 能让你快速访问网站。
搭建环境
务必按照顺序来安装！
Ⅰ 下载 git
从 git 官网下载对应的安装包：
安装好后在桌面 右键 → Open Git Bash here 输入 git --version 查看，这样显示就算安装成功了：
打开你下载 git 的目录，右键 git-bash.exe 选择[属性]并如下选择：
Ⅱ 下载 Node.js
从 Node.js 官网下载对应的安装包：
在 Git Bash 中输入 node -v，不报错即可。
环境配置参考这里。
Ⅲ 安装 Hexo
在 Git Bash 中输入 （这一步换下载源，是为了后面下载不报错）。输入npm install -g hexo，等待完成后，输入hexo -v。
更正：淘宝的镜像源已经修改为 https://registry.npmmirror.com，请参照本教程的朋友及时修正。
继续输入 npm install --save hexo-deployer-git安装依赖。
到这里，全部环境就搭建好了，下面是正式的搭建博客环节。
使用 git 生成 SSH key
如果你的用户名称中含有中文，这一步不建议在 Git Bash 中操作。Windows自带搜索框搜索cmd，右键→以管理员身份运行是更好的选择。
如果你到现在都没有自己的 GitHub 账户，就现在去注册一个并设置好用户名。
在 Git Bash 或 cmd 中输入ssh-keygen -t rsa -C "填你注册 GitHub 的邮件地址"，按三次回车后，会像这样：
然后输入clip < ~/.ssh/id_rsa.pub，将刚刚生成的 SSH 密钥复制到剪贴板。如果是 cmd，就把~/.ssh/id_rsa.pub改成 id_rsa.pub 的绝对路径。
接着打开 GitHub 主页，点击个人设置，点击左侧的 SSH and GPG keys，点击 New SSH key。
将你的剪贴板里的东西复制进去，Title 随意取：
输入ssh -T [email protected]测试，接着输入yes，不报错即可。接着设置你的个人信息：
git config --global user.name "karlbaey101" # 你的github用户名
git config --global user.email "[email protected]" # 填写你的github注册邮箱
搭建博客
新建博客
开始之前先介绍一下 Hexo 的基本命令
hexo new "postName" # 新建文章
hexo new draft "draftName" # 新建草稿
hexo new page "pageName" # 新建页面
hexo generate # 生成静态页面至 public 目录
hexo server # 开启预览访问端口（默认端口4000，'ctrl + c'关闭server）
hexo deploy # 部署到GitHub
hexo help # 查看帮助
hexo version # 查看Hexo的版本
对应的缩写，比如：
hexo n == hexo new
hexo g == hexo generate
hexo d == hexo deploy
hexo s == hexo server
新建一个保存博客的存放目录，必须是空文件夹。比如卡尔白的是：E:\Karlblogs
在你的存放目录右键→ Open Git Bash here，输入命令hexo init
查看你的存放目录，里面应该出现了这些：
生成静态网页并预览:
hexo g && hexo s浏览器输入http://localhost:4000
报错解决： 问题：hexo g 报错，
line.mathALL is not function问题解决 原因：nodejs 版本低于12 解决：两种方法
- 请将 nodejs 升级到高于12.0.0的版本
- _config.yml 中的 highlight->enable 的值从
true更改为false，这样可以避免异常。
访问没问题了，接下来部署到 GitHub。
部署到 GitHub
注意： 此处需要一个新仓库（Repository），仓库名称格式：用户名.github.io。比如卡尔白的就是：karlbaey101.github.io。
编辑_config.yml，_config.yml在博客存放目录下：
deploy:
type: git
repository: [email protected]:Owner/Repo
branch: main
message: Commonly updation
repository 仓库地址改为自己的。branch 看自己的 GitHub 仓库是 master 还是 main，卡尔白这里是 main，所以就填写 main。message 填上你希望的提交信息。
发布到 GitHub，命令：hexo d。
在浏览器访问：https://karlbaey101.github.io/
不出意外即可成功访问。
这个博客地址已经是部署到了公网中的
karlbaey.top，感兴趣的读者也可以访问。
编写博客
搭建好博客之后，日常中肯定是需要编写博客并且同步到 GitHub。卡尔白来带大家写一篇博客。
新建一篇名为Karl-first-blog的博客：hexo n "Karl-first-blog"
查看对应的文件夹：
可以看到生成了一个Karl-first-blog.md文件，通过这个 Markdown 文件去写博客。（这里用的是 VSCode 来编辑，也推荐用 Typora 或 Obsidian 等专用富文本编辑器来写）
默认的内容是这样的：
---
title: Karl-first-blog
date: 2025-02-10 23:47:31
tags:
---
这里开始编写正文（markdown 格式）
使用 markdown 格式编写好后，在博客存放目录右键→ Open Git Bash here，输入hexo g && hexo d，你的博客就被部署到网站上了。访问网站就能看到。
结语
到这里，你就应该会写博客和部署博客了，（如果有）下一期就告诉诸位怎么导入模板和网站操作。
完结撒花！🎇🎇🎇
脚注
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
游客24 楼