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 config set registry https://registry.npm.taobao.org（这一步换下载源，是为了后面下载不报错）。输入npm install -g hexo，等待完成后，输入hexo -v。

继续输入 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 git@github.com测试，接着输入yes，不报错即可。接着设置你的个人信息：

git config --global user.name "karlbaey101" #你的github用户名
git config --global user.email "xxx@example.com" #填写你的github注册邮箱

搭建博客

新建博客

开始之前先介绍一下 Hexo 的基本命令

hexo new "postName" #新建文章
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
解决：两种方法
方法1）请将nodejs升级到高于12.0.0的版本
方法2）config.xml中的 highlight->enable的值从true更改为false，这样可以避免异常。

访问没问题了，接下来部署到 GitHub。

部署到github

注意： 此处需要一个新仓库（Repository），仓库名称格式：用户名.github.io。比如卡尔白的就是：karlbaey101.github.io。

编辑_config.yml，_config.yml在博客存放目录下：

_config.yml

deploy:
  type: git
  repository: git@github.com: 
  branch: main

repository仓库地址改为自己的。branch 看自己的 GitHub 仓库是 master 还是 main，卡尔白这里是 main，所以就填写 main。

发布到 GitHub，命令：hexo d。
在浏览器访问：https://karlbaey101.github.io/

不出意外即可成功访问。

这个博客地址已经是部署到了公网，感兴趣的读者也可以访问。

编写博客

搭建好博客之后，日常中肯定是需要编写博客并且同步到 GitHub。卡尔白来带大家写一篇博客。

新建一篇名为Karl-first-blog的博客：hexo n "Karl-first-blog"

查看对应的文件夹：

可以看到生成了一个Karl-first-blog.md文件，通过这个md文件去写博客

默认的内容是这样的：

Karl-first-blog.md

---
title: Karl-first-blog
date: 2025-02-10 23:47:31
tags:
---
这里开始编写正文（markdown格式）

使用 markdown 格式编写好后，在博客存放目录右键→ Open Git Bash here，输入hexo g && hexo d，你的博客就被部署到网站上了。访问网站就能看到。

结语

到这里，你就应该会写博客和部署博客了，（如果有）下一期就告诉诸位怎么导入模板和网站操作。

完结撒花！🎇🎇🎇