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博客的開發者使用。