macOS 上的 Jekyll
支持的 macOS 版本
- Ventura(macOS 13)
- Monterey(macOS 12)
- Big Sur(macOS 11)
较旧的 macOS 版本可能可以使用,但我们不正式支持它们。
安装 Ruby
要在 macOS 上安装 Jekyll,你需要一个合适的 Ruby 开发环境。虽然 macOS 预装了 Ruby,但我们不建议使用该版本来安装 Jekyll。这篇外部文章介绍了 为什么不应使用系统 Ruby 的各种原因。
相反,你需要使用版本管理器(例如 asdf、chruby、rbenv 或 rvm)安装一个单独的较新版本的 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 安装 chruby
和 ruby-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
故障排除
请参阅 故障排除 或 在我们的论坛上寻求帮助。