必须先安装Homebrew、Git和Node.js（LTS版）：执行官方脚本安装Homebrew并验证版本≥4.x；再用brew install git和brew install node安装Git与Node.js，确保node -v为v18.20.x/v20.15.x、npm -v≥10.7.0；禁用nvm等版本管理器以防权限冲突。
要在Mac上快速搭建一个可预览、可写作、可部署的本地静态个人博客，必须先完成Hexo运行所依赖的底层环境链：Homebrew作为包管理中枢，Git用于版本控制与后续部署，Node.js则是Hexo本身执行和渲染的核心运行时——缺一不可，顺序也不能颠倒。
安装 Homebrew 包管理器
打开 Terminal，粘贴并执行官方安装脚本：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
安装完成后，运行 brew --version 确认输出为 4.x 或更高版本。Apple Silicon（M1/M2/M3）芯片的 Mac 将自动安装到 /opt/homebrew，Intel 芯片则为 /usr/local；这个路径差异会影响后续某些工具的 PATH 配置，但 Homebrew 会自动处理，无需手动干预。
安装 Git 和 Node.js（LTS 版本）
在 Terminal 中依次执行：
brew install git
brew install node
验证安装结果：
git --version → 应返回 2.30+ 版本
node --version → 必须为 v18.20.x 或 v20.15.x（2026年 Hexo 7.x 官方强依赖的 LTS 版本）
npm --version → 应 ≥ 10.7.0
⚠️ 如果你之前用 nvm、fnm 或其他 Node 版本管理器装过多个 Node，【请先卸载或禁用它们，再用 brew install node】，否则全局 npm 包权限极易混乱，hexo-cli 安装后命令不可用。
全局安装 Hexo CLI 工具
执行命令：
npm install -g hexo-cli
安装完成后立即验证：
hexo --version
正确输出应类似：hexo-cli: 4.3.0 和 hexo: 7.3.0。若只显示 CLI 版本而无 Hexo 核心版本，说明安装不完整，需重新运行该命令并确保网络通畅（国内用户建议临时配置 npm 镜像：npm config set registry https://registry.npmjs.org/）。
初始化你的第一个博客项目
第一步：创建项目目录并进入
mkdir ~/blog && cd ~/blog
第二步：执行初始化
hexo init
这一步会自动下载 Hexo 默认主题 Landscape 并生成标准目录结构。耗时约 10–30 秒，期间不要中断终端。
第三步：安装项目级依赖
npm install
注意：此命令必须在 ~/blog 目录下运行，它读取根目录的 package.json 安装 hexo-renderer-marked、hexo-generator-archive 等必要插件。漏掉这步会导致后续 hexo server 启动失败，报错“Cannot find module ‘hexo-renderer-marked’”。
第四步：启动本地服务
hexo server
终端将输出类似 INFO Hexo is running at http://localhost:4000/ 的提示。此时打开 Safari 或 Chrome，访问 http://localhost:4000，即可看到默认博客首页。
