一、安装 HomeBrew

HomeBrew 是 macOS 上的包管理工具，为后续安装 Ruby 和 Jekyll 提供基础支持。推荐使用国内镜像脚本加速安装：

/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"

执行后根据提示选择合适的镜像源（如中科大、清华大学等），输入系统密码完成安装。安装完成后，可通过以下命令验证：

brew --version

若显示版本信息，则说明安装成功。

二、Jekyll 与 GitHub Pages 博客搭建

1. 创建 GitHub 仓库

  • 登录 GitHub，点击右上角「+」号，选择「New repository」
  • 仓库命名必须遵循格式：用户名.github.io（例如：rockyfang2024.github.io）
  • 勾选「Initialize this repository with a README」，点击「Create repository」

2. 克隆仓库到本地

打开终端，执行以下命令将远程仓库克隆到本地（替换为你的用户名）：

git clone https://github.com/你的用户名/你的用户名.github.io.git
cd 你的用户名.github.io

进入仓库目录后，即可开始配置 Jekyll 环境。

3. 安装 Jekyll 及依赖

Jekyll 依赖 Ruby 环境，推荐使用 rbenv 或 RVM 管理 Ruby 版本（避免系统 Ruby 权限问题）。

（1）安装 Ruby 环境

rvm install "ruby-3.2.2"

（2）安装 Jekyll

# 安装 bundler 和 jekyll
gem install bundler jekyll

jekyll new myblog

cd myblog

# 安装项目依赖
bundle install

（3）启动本地服务器

bundle exec jekyll serve

执行成功后，终端会显示类似以下信息：

Server address: http://127.0.0.1:4000/
Server running... press ctrl-c to stop.

打开浏览器访问 http://127.0.0.1:4000，即可预览你的博客。

4. 发布博客到 GitHub

当本地预览效果满意后，通过以下命令将内容推送到 GitHub：

# 添加所有修改
git add .

# 提交修改
git commit -m "初始化博客站点"

# 推送到远程仓库
git push origin main

几分钟后，访问 https://你的用户名.github.io 即可看到在线博客。

三、使用 Jekyll 撰写文章

1. 安装 Jekyll Compose 插件（可选）

Jekyll Compose 可以简化文章创建流程，推荐安装：

（1）配置插件

在项目根目录的 Gemfile 中添加以下内容：

group :jekyll_plugins do
  gem 'jekyll-compose'
end

（2）加速依赖安装

若 bundle install 速度较慢，可配置国内镜像源：

# 中科大 RubyGems 镜像
bundle config mirror.https://rubygems.org https://mirrors.ustc.edu.cn/rubygems/

# 安装插件
bundle install

2. 创建新文章

使用以下命令快速创建文章（自动生成符合格式的文件）：

bundle exec jekyll post "我的第一篇博客"

执行后，会在 _posts 目录下生成类似 2025-07-30-我的第一篇博客.md 的文件，文件名格式为「YYYY-MM-DD-文章标题.md」。