在 macOS 上用 Homebrew 安装 Hugo 搭建静态博客的核心三步是：先安装 Homebrew（含 Xcode 命令行工具和清华源加速），再执行 brew install hugo 安装 Hugo，最后通过 hugo new site、配置主题、hugo new 和 hugo server -D 初始化并预览站点。
在 macos 上用 homebrew 安装 hugo 搭建静态博客，核心是三步：装好 homebrew、用它装 hugo、再初始化一个 hugo 站点。整个过程不需要图形界面操作，终端几条命令就能跑起来。
先装 Homebrew（包管理器）
Homebrew 是 macOS 上最常用的软件安装工具，相当于“命令行应用商店”。它不是系统自带的，得手动装：
- 打开终端，先装 Xcode 命令行工具（必需依赖）：
xcode-select --install - 弹窗点“安装”，等进度条结束；验证是否成功：
xcode-select -p应返回/Library/Developer/CommandLineTools - 国内用户推荐用清华源一键安装（避免 GitHub 超时）：
/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)" - 脚本运行中选“2”（清华源），输管理员密码（输时不显示字符，直接回车）
- 安装完执行提示里的环境变量命令（通常是
eval "$(/opt/homebrew/bin/brew shellenv)"），再运行brew --version和brew doctor确认就绪
再用 Homebrew 装 Hugo
Hugo 是一个独立可执行文件，不用 Node.js 或 Python 环境，装起来特别快：
macOS Local Voice
下载
利用 macOS 原生能力实现本地语音识别与合成。通过 yap (Apple Speech.framework) 进行语音转文字，通过 say + ffmpeg 进行文字转语音。完全离线，无需 API 密钥。具备音质检测与智能选声功能。
- 终端输入：
brew install hugo - 装完检查版本：
hugo version
看到类似hugo v0.125.0+extended darwin/arm64就说明成功 - 如果提示 command not found，可能是 shell 配置没生效，重新执行
source ~/.zshrc（Apple Silicon Mac）或source ~/.zshrc（Intel Mac）
初始化 Hugo 博客项目
装好 Hugo 后，就可以快速生成一个带主题的站点：
- 创建新站点：
hugo new site myblog（myblog是文件夹名，可自定义） - 进入目录：
cd myblog - 添加主题（比如官方推荐的
ananke）：git init && git submodule add https://github.com/theNewDynamic/gohugo-theme-ananke.git themes/ananke - 启用主题：编辑
config.toml，把theme = ""改成theme = "ananke" - 新建一篇博文：
hugo new posts/my-first-post.md - 启动本地预览：
hugo server -D（-D表示显示草稿），然后访问http://localhost:1313
后续部署到 GitHub Pages（可选但常用）
生成静态文件后，可以直接推送到 GitHub 仓库的 gh-pages 分支或 main 的 docs 目录：
- 生成静态文件：
hugo -d docs（输出到docs文件夹） - 提交到 GitHub 仓库，并在 Settings → Pages 中选择
Deploy from a folder，路径设为/docs - 稍等一两分钟，就能通过
https://<用户名>.github.io/<仓库名>访问
