Homebrew 是 macOS 上安装静态网站生成器最省心的方式,可自动处理依赖、管理版本、避免环境冲突;支持一键安装 Hugo、Jekyll 等工具,Hexo 需先 brew install node 再 npm 安装 CLI,全程无需管理员权限且环境隔离。
homebrew 是 macos 上安装静态网站生成器最省心的方式。它能自动处理依赖、管理版本、避免环境冲突,比手动下载或用 python pip 安装更稳定可靠。
确认 Homebrew 已安装并更新
先确保你已装好 Homebrew,并且源是可用的国内镜像(比如清华或中科大源),否则后续下载会极慢甚至失败。
- 终端运行 brew --version 查看是否输出版本号
- 若提示命令未找到,请先安装 Homebrew(推荐用清华镜像脚本:
/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)") - 运行 brew update 确保软件列表最新
常用静态网站生成器一键安装
主流工具基本都支持 brew 安装,无需额外配置 Python 或 Node 环境:
-
Hugo(Go 编写,极速,适合博客/文档):
brew install hugo -
Jekyll(Ruby 编写,GitHub Pages 原生支持):
brew install jekyll(注意:需系统有 Ruby,macOS 自带但版本可能低;如报错可先brew install ruby并调整 PATH) -
Hexo(Node.js 编写,插件丰富):
brew install node→ 再执行npm install -g hexo-cli(Homebrew 不直接托管 Hexo,但能快速装好 Node 环境) -
Obsidian Publish 的替代方案(如 Zola):
brew install zola
验证安装并快速启动一个站点
以 Hugo 为例,验证是否可用,并生成预览站点:
- 运行 hugo version 看是否显示版本信息
- 新建项目:
hugo new site myblog - 进入目录:
cd myblog - 添加主题(例如使用官方推荐的 PaperMod):
git init && git submodule add https://github.com/adityatelange/hugo-PaperMod themes/PaperMod - 启用主题并启动本地服务:
hugo server -D,打开http://localhost:1313即可实时预览
后续维护与升级
用 Homebrew 安装后,日常维护很简单:
- 升级 Hugo:
brew upgrade hugo - 查看所有已装工具:
brew list | grep -E "(hugo|jekyll|zola)" - 卸载某个工具:
brew uninstall hugo - 清理旧版本缓存:
brew cleanup
整个过程不依赖管理员密码、不修改系统路径、不污染全局环境,每个生成器彼此隔离,换工具或重装都很轻量。


















