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:安裝 chruby 和最新 Ruby(使用 ruby-install)

使用 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,請將 .zshrc 替換為 .bash_profile。如果您不確定,請閱讀此外部指南以 找出您正在使用的 shell

退出並重新啟動終端機,然後檢查一切是否正常運作

ruby -v

它應顯示 ruby 3.1.3p185(2022-11-24 修訂版 1a6b16756e)或更新版本。

接下來,閱讀同一個外部指南,以取得有關 使用 chruby 設定和切換 Ruby 版本 的重要注意事項。

安裝 Jekyll

使用 chruby 安裝 Ruby 後,安裝最新的 Jekyll gem

gem install jekyll

疑難排解

請參閱 疑難排解在我們的論壇上尋求協助