本指南将带你从零开始,解决在 Mac 电脑上搭建 Hexo 博客时遇到的常见问题,并最终实现本地后台管理功能。


第一步:安装 Node.js 与 Hexo-CLI

在开始前,请确保你的 Mac 已经安装了 Node.js

可以访问 Node.js 官网 下载安装,推荐下载 LTS 版本。

点击下面链接,下载nodejs并安装到本地。

https://nodejs.org/zh-cn/download

你是mac就选择mac,是Windows还是Linux就选择对应的。

建议LTS的最新版本。如图此刻是22.19LTS最新版本。

安装完毕后,建议先打开终端(Windows里叫cmd命令窗口)输入以下代码并按下回车查阅是否安装成功

node --version

有提示你下载对应的版本号,就意味着成功了。

顺便查询一下npm 的版本号(安装nodejs会附带)

也有提示就是代表一样成功啦!

安装完成后,打开终端,通过 npm 全局安装 Hexo 的命令行工具:

1
npm install -g hexo-cli

PS:在这过程中我遇到了权限问题,附上解决权限错误的办法:

如果在安装时遇到 EACCES: permission denied 错误,这是由于你当前用户没有权限写入系统目录。请执行以下命令来解决此问题:

  1. 修改 node_modules 目录权限:
1
sudo chown -R $(whoami) $(npm root -g)
  1. 修改 bin 目录权限:
1
sudo chown -R $(whoami) /usr/local/bin

完成权限修改后,再次运行 npm install -g hexo-cli,即可成功安装。


第二步:初始化 Hexo 项目并安装依赖

选择一个你喜欢的目录,作为你的博客根目录。运行以下命令来初始化一个新的 Hexo 项目:

1
2
hexo init blog
cd blog

hexo init 命令会自动创建必要的文件夹和配置文件,cd 命令则会进入到你的项目目录。

进入项目目录后,你需要安装 Hexo 核心模块及其它依赖。通常只需要运行 npm install

1
npm install

解决本地安装权限问题

如果在安装本地依赖时遇到 EACCES 错误,这很可能是 npm 缓存权限问题。请运行以下命令来修复:

1
sudo chown -R 501:20 "/Users/你的用户名/.npm"

备注:你的用户名 替换为你 Mac 上的实际用户名。修复后,再次运行 npm install


第三步:本地预览与博客后台管理

本地预览

所有依赖安装完毕后,可以运行以下命令在本地启动 Hexo 服务器进行预览:

1
hexo server

在浏览器中访问 http://localhost:4000/,你将看到一个 Hexo 博客的初始界面。

我还为了像WordPress一样,安装后台管理插件

Hexo 默认没有后台管理界面,但你可以通过安装插件来实现。暂时推荐使用 hexo-admin,它提供了一个类似于 WordPress 的管理界面。

在你的博客根目录下,运行以下命令安装插件:(就是要在新的终端里面打开定位:cd blog)

1
npm install hexo-admin --save

安装完成后,再次运行 hexo server,然后访问 http://localhost:4000/admin/。首次访问时,你需要设置一个用户名和密码。设置完成后,你就可以在浏览器中创建、编辑和发布文章了。


OK 到这里为止,本指南完成了 Hexo 博客在本地的搭建和管理界面的办法。

下一篇,我将讲解如何将你的 Hexo 博客部署到 GitHub Pages,让全世界都能访问。

温馨提示:官网本地部署指导文档地址,不过很多年没有更新了,所以自己写了一下自己的思考和解决过程。

https://hexo.io/zh-cn/docs/