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:安裝 chruby 和最新 Ruby(使用 ruby-install)
使用 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,請將 .zshrc
替換為 .bash_profile
。如果您不確定,請閱讀此外部指南以 找出您正在使用的 shell。
退出並重新啟動終端機,然後檢查一切是否正常運作
ruby -v
它應顯示 ruby 3.1.3p185(2022-11-24 修訂版 1a6b16756e)或更新版本。
接下來,閱讀同一個外部指南,以取得有關 使用 chruby 設定和切換 Ruby 版本 的重要注意事項。
安裝 Jekyll
使用 chruby 安裝 Ruby 後,安裝最新的 Jekyll gem
gem install jekyll
疑難排解
請參閱 疑難排解 或 在我們的論壇上尋求協助。