Mac 系统从零安装 Hexo 完整教程（保姆级）

Hexo 是基于 Node.js 的静态博客框架，Mac 环境下安装非常清爽，全程用终端即可完成。下面一步步带你装好并跑起来。

一、先安装必备环境

Hexo 只依赖两个东西：Node.js + Git。

1. 安装 Homebrew（推荐）

打开 Mac 自带的 「终端」，先装 Homebrew（后面装软件超方便）：

1
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2. 用 brew 安装 Node.js 和 Git

1
brew install node git

安装完检查一下：

1
2
3
node -v
npm -v
git --version

出现版本号就说明成功了。

二、安装 Hexo

继续在终端执行：

1
npm install -g hexo-cli

验证：

1
hexo -v

能看到 hexo 版本信息就 OK。

三、初始化你的博客

  1. 先找个地方放博客文件，比如在桌面建一个文件夹：
1
2
3
cd ~/Desktop
mkdir my-hexo-blog
cd my-hexo-blog
  1. 初始化 Hexo：
1
hexo init
  1. 安装依赖：
1
npm install

四、本地运行 Hexo

  1. 生成静态文件：
1
2
3
hexo generate
# 简写
hexo g
  1. 启动本地服务：
1
2
3
hexo server
# 简写
hexo s
  1. 打开浏览器访问：
1
http://localhost:4000

看到 Hexo 默认页面，说明安装成功！

五、常用命令总结

  • hexo new "文章标题" → 新建文章
  • hexo g → 生成页面
  • hexo s → 本地预览
  • hexo clean → 清理缓存（页面异常时用）

六、常见小问题

  1. 权限报错
    1
    sudo npm install -g hexo-cli
  2. 端口被占用
    1
    hexo s -p 4001
  3. 安装很慢
    切换镜像：
    1
    npm config set registry https://registry.npmmirror.com