Jekyll是一款基于Ruby开发的静态站点生成器，以MIT协议开源。Jekyll诞生于2008年，由GitHub联合创始人Tom Preston-Werner创建，是GitHub Pages官方支持的静态站点生成器。Jekyll支持Markdown写作，使用Liquid模板引擎，将纯文本转换为静态HTML网站，可部署到GitHub Pages、Netlify、Vercel、自有服务器等任何静态托管平台。Jekyll适合搭建个人博客、技术文档、项目主页、作品集。
核心优势：GitHub Pages原生支持（免费托管）、轻量快速、Markdown写作、Liquid模板引擎、丰富的主题和插件、完全静态（无需数据库）、部署灵活、安全性高、Git友好（内容版本管理）、社区活跃。Jekyll是GitHub用户和技术博主的首选静态博客工具。
环境要求
- 操作系统：Windows / macOS / Linux
- Ruby版本：Ruby 2.7 ~ 3.2（Jekyll 4.x推荐Ruby 3.0+）
- RubyGems：随Ruby安装
- 内存：最低256MB，推荐512MB以上
- 磁盘：至少500MB可用空间
- Git：用于版本管理和部署（必需）
- 文本编辑器：VS Code / Sublime Text等（推荐）
安装教程
步骤1：安装Ruby
Windows：
- 下载RubyInstaller（https://rubyinstaller.org/downloads/），选择Ruby+Devkit 3.x版本
- 双击安装，勾选”Add Ruby executables to your PATH”
- 安装完成后运行命令提示符，验证：
ruby --version和gem --version
macOS（Homebrew）：
brew install ruby
echo 'export PATH="/usr/local/opt/ruby/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
ruby --versionLinux（Ubuntu/Debian）：
sudo apt update
sudo apt install -y ruby-full build-essential zlib1g-dev
echo '# Install Ruby Gems to ~/gems' >> ~/.bashrc
echo 'export GEM_HOME="$HOME/gems"' >> ~/.bashrc
echo 'export PATH="$HOME/gems/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
ruby --version步骤2：安装Jekyll和Bundler
gem install jekyll bundler
jekyll --version
bundler --version步骤3：创建Jekyll站点
jekyll new my-blog
cd my-blog这会创建一个标准的Jekyll站点结构，包含默认主题（minima）和示例文章。
步骤4：本地预览
bundle exec jekyll serve访问 http://localhost:4000 即可看到博客首页。按Ctrl+C停止服务器。
步骤5：配置站点信息
编辑站点根目录下的 _config.yml 文件：
title: 我的博客
description: 分享技术与生活
author: 你的名字
url: "https://yourusername.github.io"
baseurl: ""
# Build settings
markdown: kramdown
theme: minima
plugins:
- jekyll-feed
- jekyll-seo-tag
# Social links
twitter_username: jekyllrb
github_username: jekyll
# Exclude from processing
exclude:
- Gemfile
- Gemfile.lock
- node_modules
- vendor步骤6：撰写文章
在 _posts 目录下创建Markdown文件，文件名格式为 YYYY-MM-DD-文章标题.md：
---
layout: post
title: "我的第一篇文章"
date: 2026-09-12 18:00:00 +0800
categories: 技术
tags: [Jekyll, 博客]
---
这里是文章正文，使用Markdown语法。
## 二级标题
正文内容...步骤7：构建静态文件
bundle exec jekyll build生成的静态文件保存在 _site 目录下。
步骤8：部署到GitHub Pages
8.1 创建GitHub仓库
在GitHub创建一个名为 你的用户名.github.io 的public仓库。
8.2 初始化Git并推送
git init
git add .
git commit -m "Initial commit"
git branch -M main
git remote add origin https://github.com/你的用户名/你的用户名.github.io.git
git push -u origin main推送后GitHub会自动构建并部署，访问 https://你的用户名.github.io 即可。
步骤9：部署到自有服务器（可选）
将 _site 目录下的所有文件上传到服务器网站根目录即可，无需Ruby、数据库等环境。
# 使用rsync同步到服务器
rsync -avz --delete _site/ user@yourserver:/www/wwwroot/yourdomain.com/Windows环境注意事项
- 必须安装Ruby+Devkit版本，否则编译原生扩展会失败
- 建议使用Git Bash或Windows Terminal获得更好的命令行体验
- 文件路径不要包含中文和空格，避免编码问题
- 首次运行
jekyll serve可能较慢，需要安装依赖
宝塔面板部署（静态站点）
- 在本地执行
bundle exec jekyll build生成静态文件 - 宝塔面板添加站点，PHP版本选择”纯静态”
- 将
_site目录下的所有文件上传到网站根目录 - 配置Nginx：开启gzip压缩，设置静态资源缓存
- 配置SSL证书（宝塔一键部署Let’s Encrypt）
- 可选：配置GitHub Actions自动构建部署
服务器配置建议（自有服务器部署）
- Nginx配置纯静态站点，无需Ruby/PHP/MySQL
- 启用gzip/brotli压缩
- 配置静态资源缓存策略（CSS/JS/图片长缓存，HTML短缓存）
- 配置HTTPS（Let’s Encrypt免费证书）
- 设置404页面
- 使用CDN加速静态资源
- 本地构建时使用
JEKYLL_ENV=production bundle exec jekyll build启用生产环境优化
常见问题
Q：gem install jekyll失败？
A：Windows确保安装了Ruby+Devkit版本。Linux安装build-essential和zlib1g-dev。macOS安装Xcode命令行工具：xcode-select --install
Q：jekyll serve启动后无法访问？
A：检查4000端口是否被占用，可指定其他端口：bundle exec jekyll serve --port 5000。检查防火墙是否开放端口。
Q：GitHub Pages部署后样式丢失？
A：检查_config.yml中的url和baseurl配置是否正确。如果部署到子目录，需要设置baseurl为子目录路径。
Q：如何更换主题？
A：在_config.yml中修改theme字段，或使用remote_theme引用GitHub主题。常用主题：minima（默认）、just-the-docs、minimal-mistakes、beautiful-jekyll等。
Q：Jekyll和Hexo怎么选？
A：需要GitHub Pages原生支持、Ruby生态选Jekyll；追求生成速度、Node.js生态、中文社区选Hexo。GitHub用户推荐Jekyll，普通用户推荐Hexo。
官方网址
Jekyll官网地址：https://jekyllrb.com