← 返回文章列表

Mac安裝Jekyll

在 macOS 上準備 Ruby、安裝 Jekyll,並啟動本地部落格。

更新了在Windows的Jekyll教程。順便把環境在Mac上重新配置了一遍,把完整流程記錄下來,給正在折騰部落格的你一份可直接照做的macOS安裝指南。

本文預設你使用 zsh 終端(macOS 預設),並透過 rbenv 管理 Ruby 版本,避免系統自帶 Ruby 的許可權與相容問題。


第一步:準備基礎環境

1. 安裝 Homebrew(已裝可跳過)

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

安裝完成後,根據提示把 brew 加入 PATH,並重新開啟終端或執行 source ~/.zshrc。

2. 安裝 rbenv 與 ruby-build

brew update
brew install rbenv ruby-build

3. 初始化 rbenv(zsh)

echo 'eval "$(rbenv init - zsh)"' >> ~/.zshrc
source ~/.zshrc

第二步:安裝 Ruby 與 Jekyll

1. 安裝較新的 Ruby(示例使用 3.3.5)

rbenv install 3.3.5
rbenv global 3.3.5
ruby -v

2. 安裝 Bundler 和 Jekyll

gem install bundler jekyll

第三步:在專案中安裝依賴並啟動

在你的部落格主目錄下執行:

bundle install
bundle exec jekyll serve

看到成功提示後,在瀏覽器訪問:

http://127.0.0.1:4000

mac_jekyll

安裝完成!🎉

恭喜!現在你已經在 macOS 上成功安裝並執行了 Jekyll。後續可以在 _config.yml 中調整主題與配置、在 _posts 中編寫文章,用 bundle exec jekyll build 生成靜態檔案進行部署。

關於這篇文章的日期

保留舊站原始文章標註的日期;實際開始寫作的時間可能更早。

原始日期: 2025-10-24 21:11:11 +0800