macOS 上的 Jekyll

支持的 macOS 版本

  • Ventura(macOS 13)
  • Monterey(macOS 12)
  • Big Sur(macOS 11)

较旧的 macOS 版本可能可以使用,但我们不正式支持它们。

安装 Ruby

要在 macOS 上安装 Jekyll,你需要一个合适的 Ruby 开发环境。虽然 macOS 预装了 Ruby,但我们不建议使用该版本来安装 Jekyll。这篇外部文章介绍了 为什么不应使用系统 Ruby 的各种原因。

相反,你需要使用版本管理器(例如 asdfchrubyrbenvrvm)安装一个单独的较新版本的 Ruby。版本管理器允许你轻松安装多个版本的 Ruby,并在它们之间切换。

我们推荐 chruby,因为它最简单,最不容易出现问题。

以下说明摘自这篇详细的外部指南,内容是 在 Mac 上安装 Ruby。如果你在 Mac 上首次设置开发工具,它们最有效。如果你已尝试在 Mac 上安装 Ruby 或 Jekyll,或者遇到任何问题,请阅读该指南。

步骤 1:安装 Homebrew

Homebrew 使得在 Mac 上安装开发工具变得简单。

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

步骤 2:使用 ruby-install 安装 chruby 和最新 Ruby

使用 Homebrew 安装 chrubyruby-install

brew install chruby ruby-install xz

安装 Ruby 的最新稳定版本(Jekyll 支持)

ruby-install ruby 3.1.3

这将花费几分钟,完成后,配置你的 shell 以自动使用 chruby

echo "source $(brew --prefix)/opt/chruby/share/chruby/chruby.sh" >> ~/.zshrc
echo "source $(brew --prefix)/opt/chruby/share/chruby/auto.sh" >> ~/.zshrc
echo "chruby ruby-3.1.3" >> ~/.zshrc # run 'chruby' to see actual version

如果你使用 Bash,用 .bash_profile 替换 .zshrc。如果你不确定,请阅读此外部指南以 了解你正在使用哪个 shell

退出并重新启动终端,然后检查一切是否正常

ruby -v

它应该显示 ruby 3.1.3p185 (2022-11-24 revision 1a6b16756e) 或更新版本。

接下来,阅读同一外部指南,了解有关 使用 chruby 设置和切换 Ruby 版本 的重要说明。

安装 Jekyll

使用 chruby 安装 Ruby 后,安装最新的 Jekyll gem

gem install jekyll

故障排除

请参阅 故障排除在我们的论坛上寻求帮助