Jekyll 4.4.1 静态博客框架 5 招搭 GitHub Pages 部署,含整站框架源码、依赖清单 Gemfile、官方 README.txt 起步指南、Pages 部署清单 .txt,适合个人博客和项目文档站。
Jekyll 4 静态博客 5 招搭 GitHub Pages
你想搭一个个人博客,WordPress 太重要装数据库,Hugo 模板选择太少,VuePress 偏技术。Jekyll 4.4.1 正好 —— GitHub Pages 原生支持,Ruby 生态成熟,模板丰富,Github Pages 一键部署。下面给你 5 个判断思路,zip 里有整框架 + 起步指南 + Pages 部署清单,你下载就能用。
为什么 Jekyll 值得花时间
GitHub Pages 原生支持,git push 部署
Markdown 写作,不用后台编辑器
无数据库,纯文件存储,备份迁移 1 条 git 命令
Ruby 生态成熟,主题插件丰富
📌 速查表: Jekyll 4 核心 3 文件 →_config.yml(站点配置)+_posts/(文章目录)+_layouts/(模板)。少 1 个就跑不起来。
5 个挑选 / 避坑思路
第 1 招:[判断标准] 看 Ruby 版本要求
Jekyll 4 要求 Ruby 2.5+,推荐 2.7+ 或 3.0+。Windows 用户要先装 RubyInstaller,Linux/macOS 自带。zip 里的 Gemfile 锁定了版本兼容范围,直接 bundle install 装依赖就行。
第 2 招:[避坑点] 别用 GitHub Pages 默认 jekyll 3
Pages 默认装的是 jekyll 3.9,功能老了。要用 4 必须显式声明 remote_theme 或 actions 部署。zip 里 README.txt 第 5 段写了 Pages 部署的具体步骤。
第 3 招:[关键参数] 看 _config.yml 的 baseurl
Pages 项目部署在 username.github.io/repo/ 时必须设 baseurl: /repo。设错的话所有 CSS/JS 路径全 404。zip 里的 _config.yml 默认 baseurl 是空,部署前改成你的仓库名。
第 4 招:[易踩坑] bundle install 报错 native extension
Windows 下 nokogiri / eventmachine 等 gem 要 native 编译,经常报错。解法:用 rubyinstaller-devkit 安装 Ruby,或装 RubyInstaller-Devkit。zip 里有完整 Gemfile 锁定版本。
第 5 招:[场景建议] 个人博客 vs 项目文档
个人博客 → minima 主题最经典;项目文档 → just-the-docs 主题侧边栏强;技术博客 → chirpy 主题带 TOC + 代码高亮。zip 主框架不带主题,你按需选。
下载包里有什么
Jekyll 4.4.1 整站框架(1.1MB,106 个 .txt 起步文档)
Gemfile(依赖锁定)
_config.yml 默认配置(可改 baseurl / 主题 / 标题)
README.txt(Windows 安装 + Pages 部署步骤)
📦 2026-07-25 更新:zip 已处理成「无 md 版」 — 所有 .md 文档已转 .txt(106 个),避免 markdown 编辑器兼容问题。
为什么必须下载
比官网 zip 多一个 Pages 部署清单 .txt(官方文档要翻 5 篇文章才讲完),还把所有 .md 文档统一转 .txt,Windows 记事本可直接打开不乱码。下载就少踩 3 小时坑。
# 部署三步走 git clone https://github.com/你的用户名/你的仓库.git cd 你的仓库 git push origin main # Pages 自动构建部署
避坑点速查
❌ 不要在 _posts/ 目录放 .txt 文件名用中文 → 编码会乱
❌ 不要修改 _site/ 目录 → 那是构建产物,会被覆盖
❌ 不要在 _config.yml 里写中文逗号 → YAML 解析会报错
✅ 文章文件名必须 YYYY-MM-DD-title.txt 格式
✅ 部署前先本地
bundle exec jekyll serve测一遍
