Mac本地部署Hexo

参考文档:https://juejin.cn/post/6844904131266609165
Hexo官网:https://hexo.io/

环境:brew、fnm、pnpm、node24、git

[!WARNING]

brew、fnm、pnpm需要配置国内源

fnm VS brew 哪个更适合用来进行node版本管理

安装fnm

1
brew install fnm

查看shell,并设置环境变量/国内源

1
2
3
4
5
6
7
8
9
10
11
12
echo $SHELL

# 如果为/bin/zsh(mac 默认)
echo 'eval "$(fnm env --use-on-cd)"' >> ~/.zshrc
echo 'export FNM_NODE_DIST_MIRROR="https://npmmirror.com/mirrors/node"' >> ~/.zshrc
source ~/.zshrc

# ----------------------
# 如果为/bin/bash
echo 'eval "$(fnm env --use-on-cd)"' >> ~/.bashrc
echo 'export FNM_NODE_DIST_MIRROR="https://npmmirror.com/mirrors/node"' >> ~/.bashrc
source ~/.bashrc

安装node,及常用命令

1
2
3
4
fnm install 24    # 装 node24
fnm use 24 # 切换
fnm default 24 # 设默认
fnm ls # 已安装版本

手动安装方法

1
2
3
4
wget https://github.com/Schniz/fnm/releases/latest/download/fnm-linux.zip
unzip fnm-linux.zip
mv fnm /usr/local/bin/
chmod +x /usr/local/bin/fnm

安装pnpm

使用brew安装pnpm可能会落后于官方版本,但不会有什么影响。

1
brew install pnpm

设置国内镜像

1
pnpm config set registry https://registry.npmmirror.com/

设置环境变量

1
pnpm setup

安装hexo

1
pnpm install -g hexo-cli

构建

1
2
3
4
mkdir <folder>  #创建站点根目录
hexo init <folder> #使用Hexo初始化站点根目录
cd <folder> #进入到站点根目录
pnpm install #安装npm所依赖的文件

[!IMPORTANT]

若install时报错Run "pnpm approve-builds" to pick which dependencies should be allowed to run scripts.
是因为pnpm 默认拦截危险构建脚本,Hexo 依赖需要执行构建脚本才正常运行,运行pnpm approve-builds -a放行即可。

运行

1
2
3
4
hexo clean #= hexo c # 清除本地缓存,也就是清除public/文件夹和db.json文件。
hexo generate #= hexo g # 将souce文件夹下的Markdown和HTML文件解析到了public文件夹下,并生成了db.json文件
hexo server #= hexo s # 开启本地调试模式
hexo deploy #= hexo d # 将本地资源部署到Github Pages

Mac本地部署Hexo
https://blog.carlvictor.cn/posts/dd7e20f7.html
作者
Carl Victor
发布于
2026年7月25日
许可协议