在macOS系统上安装Jekyll静态网站生成器的完整指南

万桃琳

于 2025-05-30 09:07:08 发布

阅读量247

点赞数 5

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_00876/article/details/148324827

在macOS系统上安装Jekyll静态网站生成器的完整指南

jekyll 项目地址: https://gitcode.com/gh_mirrors/jek/jekyll

前言

Jekyll是一款流行的静态网站生成器，能够将Markdown等文本文件转换为完整的静态网站。本文将详细介绍在macOS系统上安装Jekyll的完整流程，帮助开发者快速搭建本地开发环境。

系统要求

Jekyll支持以下macOS版本：

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

虽然旧版本macOS可能也能运行Jekyll，但不建议使用，因为这些系统可能缺少必要的安全更新和功能支持。

Ruby环境准备

为什么需要独立Ruby环境

macOS系统自带了Ruby解释器，但存在几个关键问题：

系统Ruby版本通常较旧，可能不兼容最新版Jekyll
系统Ruby需要sudo权限安装gem，存在安全隐患
系统更新可能意外修改Ruby环境

Ruby版本管理工具选择

推荐使用以下任一工具管理Ruby版本：

chruby - 轻量级，配置简单
rbenv - 功能丰富，社区支持好
asdf - 支持多语言版本管理
RVM - 老牌工具，功能全面

本文以chruby为例，因为它配置简单且不易出现问题。

详细安装步骤

第一步：安装Homebrew

Homebrew是macOS上优秀的包管理工具，执行以下命令安装：

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

安装完成后，按照提示将Homebrew添加到PATH环境变量中。

第二步：安装chruby和ruby-install

通过Homebrew安装必要的工具：

brew install chruby ruby-install xz

第三步：安装最新稳定版Ruby

安装Jekyll支持的Ruby版本：

ruby-install ruby 3.1.3

安装过程可能需要几分钟时间，请耐心等待。

第四步：配置shell环境

根据你使用的shell类型（zsh或bash）进行配置：

对于zsh用户：

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

对于bash用户：

echo "source $(brew --prefix)/opt/chruby/share/chruby/chruby.sh" >> ~/.bash_profile
echo "source $(brew --prefix)/opt/chruby/share/chruby/auto.sh" >> ~/.bash_profile
echo "chruby ruby-3.1.3" >> ~/.bash_profile

配置完成后，重启终端或执行source ~/.zshrc(或source ~/.bash_profile)使配置生效。