如何快速上手 Hexo 博客

沉石鱼惊旋 · 2022-05-29 11:02:52 · 科技·工程

博客食用效果更佳

前置条件

硬件方面

有台电脑。

~~和没说有区别吗~~

安装 Node.js

官网地址。

安装后在 cmd 等命令行输入

node -v

和

npm -v

检查版本号。

安装 Git

官网地址

安装后在 cmd 等命令行输入

git --version

检查版本号。

配置 Hexo

首先，随意找一个盘，如 E盘，右键，Git Bash Here。

出现这样的界面即可。

之后，分别执行以下操作：

npm install hexo-cli -g
hexo init blog
cd blog
npm install
hexo s

PS：手残打错了，localhost:4000。

大概和我这个步骤差不多。

然后，访问 http://localhost:4000 就可以看到你的本地博客了。

大概默认是长这样。

可以 Ctrl+C 停止本地博客。

注意，一旦停止或退出 Git Bash，本地博客将立刻停止。

开始部署

建立仓库

如果想使你的博客可以被访问链接而被他人看到，不是只有你自己用这台电脑看得到，那么，就需要用 Github 进行托管，并白嫖一个二级域名。

也可以自己购买域名后按后文步骤进行域名绑定。

注册账号

GitHub。

点击进去，Sign up，注册结束后进入这样的页面。

创建仓库

点击右上角加号，New repository，创建一个仓库来托管你的网站。

打开后，在 repository name 里填写 你的注册时的用户名，也就是左边的+github.io。

一定不能擅自更改！！！

生成 SSH

为啥要用 ~~Karry5307~~ SSH 呢，要把我们本地的文件，传输至你的 Github 仓库上，被 Github 托管，然后才能被访问。

先在你的文件夹里 Git Bash，然后输入

ssh

测试是否安装。

admin@LAPTOP-U5FCCV9Q MINGW64 /e/blog
$ ssh
usage: ssh [-46AaCfGgKkMNnqsTtVvXxYy] [-B bind_interface]
           [-b bind_address] [-c cipher_spec] [-D [bind_address:]port]
           [-E log_file] [-e escape_char] [-F configfile] [-I pkcs11]
           [-i identity_file] [-J [user@]host[:port]] [-L address]
           [-l login_name] [-m mac_spec] [-O ctl_cmd] [-o option] [-p port]
           [-Q query_option] [-R address] [-S ctl_path] [-W host:port]
           [-w local_tun[:remote_tun]] destination [command [argument ...]]

大概长这样就对了。

然后输入：

ssh-keygen -t rsa -C "注册 Github 的邮件地址"

忘记了注册电邮，前往 https://github.com/settings/emails 查看。

之后，执行以下操作：

enter回车一次
输入 y
enter回车一次
enter回车一次

出现了

+---[RSA 3072]----+
|o   .. ...       |
| o .  o .  .     |
|+ o  . . .+      |
|o+  . + .+ .     |
|...  + .Sooo     |
|o.    = +oB      |
| +.. . O.o.=     |
| .+ . *.+ . o    |
| Eo. o=X.    .   |
+----[SHA256]-----+

之类的图案即可。

然后进入 C盘-User（有的电脑就叫用户）-admin（有的自己设置过可能会有偏差）-.ssh。

用记事本打开 id_rsa.pub。

Ctrl+A，Ctrl+C，Ctrl+V 全选。

接着，进入 https://github.com/settings/ssh/new 来新建个 key。

Title 随便，Key 黏贴刚才复制的文字。

然后输入

ssh -T [email protected]

确认是否绑定成功，有要输入 y 的就输入。

出现 Hi ...即可。

本地测试

在根目录里输入

hexo cl && hexo g && hexo s

然后，访问 http://localhost:4000 就可以看到你的本地博客了。

部署网站

进入根目录，在里面有个 _config.yml。

最下面应该是这样的：

# Deployment
## Docs: https://hexo.io/docs/one-command-deployment
deploy:
  type: ''

我们魔改一下：

# Deployment
## Docs: https://hexo.io/docs/one-command-deployment
deploy:
  type: git
  repository: #你的博客仓库地址，推荐用 ssh 版，我的就是 [email protected]:chen20091119/chen20091119.github.io.git
  branch: main #这里是分支，原先默认是 master，但 Github 有一次更新，把后注册的仓库改成了 main。

输入

npm install hexo-deployer-git --save

安装部署功能。

然后

hexo d

部署。

现在我们去看 Github 仓库，就会有东西了。

接着，访问你的博客地址就能看到博客了。

如果此时在命令行里或者弹出弹窗，让你输入东西，可以看参考文献部分的视频。

~~这个 B-stack 精准空降到输入部分。~~

视频好像也下架了……

这里如果你事先没有配置过 git 的话，可能会有如下报错：

感谢 @Eason_cyx 提供的图片。

那么你按着帮助，操作以下两条命令：

git config --global user.email "[email protected]"
git config --global user.name "Your Name"

其中把 [email protected] 和 Your Name 换成你的 Github 的邮箱和用户名。

然后再次执行 hexo d 即可。

执行完毕先去 Git 仓库看一眼有没有正确 push 上去，没有的话就是前面配置有误。配上的话等一两分钟就可以在对应的 .github.io 上看到你的网站了。

之后就可以开始美化啦！

更改主题

原版很难看，可以在 https://hexo.io/themes 来看主题，我在用 Argon。

argon 作者有写操作，跟着做即可。

美化博客

~~持续更新，争取每周有一个小技巧分享！~~

快捷部署

在一个地方，如你的桌面，创建一个后缀为 .sh 的文件，用记事本打开，输入以下内容：

cd 你的博客根目录
hexo cl && hexo g && hexo d

自动清空+生成+部署。

每次省五秒钟，一百二十次就是十分钟啊！（大雾

评论系统

可以去 根目录-themes-argon-_config.yml 查看。

本教学为 Giscus 评论系统。

先新建一个仓库，名字可以起 blogtalk 之类的。

注意 public！！1

把 Discussions 打开。

进入 https://github.com/apps/giscus 下载 Giscus。

点击 Install。

最后进入 Giscus，填写仓库。

之后在下方 启用 giscus 里会出现你的信息。

打开 根目录-themes-argon-_config.yml。

giscus: # https://giscus.app/zh-CN
  enable: false # 是否启用 Giscus 评论系统
  repo: ''
  repo_id: ''
  category: ''
  category_id: ''
  mapping: 'pathname'
  input_position: 'top'
  theme: 'light'
  lang: 'zh-CN'

将其中的 repo 等信息更改为你显示的信息。

大功告成，只需部署即可。

绑定域名

~~详见【置顶】如何快速白嫖顶级域名~~。

Freenom 已停止维护，故本内容已失效。

参考文献

视频好像被下架了，流汗。

FAQ

有一些细节问题好像没提到啊。

hexo d 时有如图报错怎么办？

上文写了。Ctrl+F git config 可以找到本文对应指导。

怎么在另一台电脑编辑我的文章？

很遗憾，Hexo 做不到这一点。你只能把自己本地的博客目录拷贝到另一台电脑上。然后在另一台电脑重新安装 Hexo 并且编辑文章。

另一台电脑重新配置 Hexo 直接照抄原内容就好。不需要重新建仓库。配置文件也不要修改。

如果你需要云端修改内容，那么 Hexo 不适合。有很多支持云端修改的博客网站，例如博客园和 CSDN。但是使用这类网站缺陷是不够自由。如果需要自由的，可以使用 WordPress 或者 Typecho。我用过一段时间的 Typecho，主题是 Handsome。Handsome 主题需要付费，但是后续客服很好，外观也确实是很漂亮。当然也可以选择其他主题。另外，Argon 主题在 WordPress 是持续更新中的。Hexo 的 Argon 主题作为移植版，开发者已经无力维护。

配置 Hexo Argon 主题有什么注意事项吗？

我在 2025 年 2 月初在新电脑上重新部署了一遍 Hexo Argon 主题。在『2. 修改主题配置』这一步其实可以不用操作。

另外，你也不需要跟着操作到 git pull。这是更新用的。但是开发者已经放弃了更新，只会进行 Bug 的修复，不会继续移植了。

我使用 Argon 主题后，文章下方的分享点击之后没有反应怎么办？

在近期版本中已经修复。但是 Argon 主题我在 22 年初就开始用了，导致我的版本非常落后。如果你也是很早就使用了 Argon，那么你需要更新 https://github.com/solstice23/hexo-theme-argon/blob/master/layout/_partial/article-bottom.ejs 这个文件。直接覆盖掉你原来的 article-bottom.ejs 即可。这是因为出现了文章换行导致单引号的错误。

我使用 Argon 主题后，代码块三个点遮住了代码怎么办？

这个我不太清楚是否修复了。我也发过 issue。https://github.com/solstice23/hexo-theme-argon/issues/23 但是很晚才收到了回复。我没有尝试过 EikoocS 给出的修改方案。但是你可以直接复制 http://blog.cyx2009.top/style.css 我修改后的 css。目前没发现 bug。

我想加密文章怎么办？

尽管存在插件支持加密，但是可以破解掉，我个人觉得没什么用。

加密插件在 https://github.com/D0n9X1n/hexo-blog-encrypt。官方的中文介绍在 https://github.com/D0n9X1n/hexo-blog-encrypt/blob/master/ReadMe.zh.md。

但是 https://www.iots.vip/post/hexo-password-crack 这篇文章给出了破解方案。那就是在 Linux 下使用 curl。或者使用 ChinaZ 工具。https://tool.chinaz.com/tools/pagecode。

如果你真的要写非常隐私的内容，那就别发出来吧（

我装过 Hexo，现在重新安装报错了怎么办？

跳过安装这一步（