GitHub Jekyll博客本地Win开发环境搭建

标签

后端 blog jekyll

全文链接

GitHub Jekyll博客本地Win开发环境搭建

概述

本文详细介绍了在Windows系统上搭建Jekyll博客本地开发环境的完整步骤，为GitHub Pages博客开发提供本地预览和调试能力。

环境依赖

• Ruby环境：Jekyll基于Ruby开发，需要先安装Ruby环境
• 开发工具链：需要MSYS2和MINGW开发工具链支持

环境搭建步骤

1. Ruby工具包安装

• 从RubyInstaller Downloads下载并安装Ruby+Devkit版本
• 使用默认安装选项

2. Ruby环境配置

• 在安装向导最后阶段运行ridk install
• 选择MSYS2和MINGW开发工具链选项
• 这一步是安装带有本地扩展的gems所必需的

3. Jekyll安装

• 打开新的命令提示符窗口（确保PATH环境变量生效）
• 执行gem install jekyll bundler安装Jekyll和Bundler

4. 环境验证

• 执行jekyll -v检查Jekyll是否正确安装

本地运行

在项目根目录下执行：

jekyll server

Ruby工具配置

Gem包管理器

• 默认路径：C:\Users\<userName>\.local\share\gem\ruby\<version>\
• 国内源配置：

  # 查看现有源
  gem sources -l
  # 添加国内源（可选移除默认源）
  gem sources --add https://mirrors.tuna.tsinghua.edu.cn/rubygems/
  

Bundler依赖管理器

• 国内源加速：

  bundle config mirror.https://rubygems.org https://mirrors.tuna.tsinghua.edu.cn/rubygems
  

技术特点

• 完整工具链：包含Ruby、Jekyll、Bundler等完整开发环境
• 国内源优化：提供国内镜像源配置，加速依赖下载
• 环境迁移：支持gem包文件夹整体迁移

---

该教程为Windows用户提供了完整的Jekyll本地开发环境搭建指南，特别适合需要本地预览和调试GitHub Pages博客的开发者使用。