macOS（推荐使用 Homebrew）：
brew install ruby或使用 rbenv（可管理多版本）：
brew install rbenv ruby-build
rbenv install 3.3.0 # 安装指定版本
rbenv global 3.3.0 # 设为默认版本安装完 rbenv 后，确保 shell 配置文件（
~/.zshrc）中有初始化代码：eval "$(rbenv init - zsh)"
Linux（Ubuntu/Debian）：
sudo apt install ruby-full build-essentialWindows： 推荐使用 RubyInstaller 或 WSL。
ruby -v # 应输出 ruby 3.x.x
gem -v # 应输出 gem 3.x.xgit clone https://github.com/hutaoao/hutaoao.github.io.git
cd hutaoao.github.io
# 安装 Bundler（如未安装）
gem install bundler
# 安装项目依赖
bundle install如果遇到权限问题，可以使用
bundle install --path vendor/bundle将依赖安装到项目目录下。
# 启动开发服务器（默认端口 4000）
bundle exec jekyll s
# 指定端口
bundle exec jekyll s -P 8080启动后访问 http://localhost:4000 即可预览。
jekyll s是jekyll serve的缩写，两者完全等价。
项目配置了 GitHub Actions，推送到 main 分支后会自动构建并部署到 GitHub Pages，无需手动构建。
git add .
git commit -m "新增文章"
git push推送后在 GitHub 仓库的 Actions 页面可查看构建和部署状态。
| 命令 | 说明 |
|---|---|
bundle exec jekyll s |
启动本地开发服务器 |
bundle exec jekyll s --draft |
开发模式下包含草稿文章 |
在 _posts/ 目录下新建 Markdown 文件，文件名格式为 YYYY-MM-DD-文章标题.md。
文件头部需要包含 Front Matter：
---
title: 文章标题
date: 2026-04-01
categories: [分类]
tags: [标签1, 标签2]
---草稿放在 _drafts/ 目录下，使用 jekyll s --draft 预览。
主要配置文件为 _config.yml，包含站点标题、描述、主题、社交链接等设置。