macOS 上用 Homebrew 配置 Jekyll 环境的核心是绕开系统 Ruby，通过 Homebrew 安装独立新版 Ruby（3.0+），配置 PATH 优先调用 Homebrew Ruby，换国内源后安装 bundler 和 jekyll，并用 jekyll new 创建站点。
macos 上用 homebrew 配置 jekyll 环境，核心是绕开系统自带 ruby（版本旧、权限受限），用 homebrew 装一套干净、可控的 ruby + jekyll 工具链。整个过程不复杂，但关键步骤不能跳过。
装 Homebrew 和新版 Ruby
Homebrew 是 macOS 上最稳妥的包管理器，它能帮你装出独立于系统、可自由管理的 Ruby。
- 先装 Homebrew（如果还没装）：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" - 再用 Homebrew 安装 Ruby（推荐 3.0+，避免兼容问题）：
brew install ruby - 安装完成后，Ruby 可执行文件在
/opt/homebrew/bin/ruby（Apple Silicon）或/usr/local/bin/ruby（Intel），不是系统路径下的/usr/bin/ruby
配置 Shell 环境变量
必须让终端优先调用 Homebrew 装的 Ruby，而不是系统默认那个。否则 gem install jekyll 会失败或装到错误位置。
- 确认你当前 Shell：
echo $SHELL（zsh 是 macOS Catalina 及之后默认，bash 较老） - 修改对应配置文件：
• zsh 用户：编辑~/.zshrc
• bash 用户：编辑~/.bash_profile - 追加两行（路径以
brew --prefix ruby输出为准）：export PATH="/opt/homebrew/opt/ruby/bin:$PATH"export PATH="$HOME/.gem/ruby/$(ruby -e 'print RUBY_VERSION')/bin:$PATH" - 重载配置：
source ~/.zshrc或source ~/.bash_profile - 验证：
ruby -v应显示 3.x 版本which ruby应指向 Homebrew 路径
换源 + 安装 Jekyll 及依赖
国内用户直接 gem install 常因网络问题失败，换国内镜像源是必要前置动作。
- 查看当前源：
gem sources -l - 删掉默认源，加国内镜像（推荐 Ruby China）：
gem sources --remove https://rubygems.org/gem sources -a https://gems.ruby-china.com/ - 安装 Bundler（项目级依赖管理）和 Jekyll：
gem install --user-install bundler jekyll - 常见报错如缺
rouge或webrick，按提示单独装：gem install rouge webrick
创建并运行第一个 Jekyll 站点
环境配好后，建站只需三步，无需手动写配置文件。
- 新建项目：
jekyll new myblog - 进入目录：
cd myblog - 启动本地服务：
bundle exec jekyll serve
成功后访问http://localhost:4000即可看到默认首页 - 如果提示
Could not find gem 'webrick'，运行：bundle add webrick再重试
整个流程下来，你拥有的是一套完全由自己控制、与系统隔离、升级维护方便的 Jekyll 环境。后续更新 Ruby 或 Jekyll，只需 brew upgrade ruby 和 gem update jekyll 即可。
