Windows上Jekyll开发环境快速搭建攻略

在Windows系统上快速搭建Jekyll开发环境是许多博客爱好者的需求。本文详细介绍了从下载必要软件到安装和配置Jekyll的完整过程，适用于新手和老手。新手可选择官方源或加速源下载Ruby和MSYS2，而老手只需几个命令即可完成环境搭建。此外，文章还提供了如何让本地Jekyll博客运行起来的步骤，并提及了可能遇到的依赖包版本不匹配问题及解决方法。最后，文中特别提醒了Ruby跨版本升级时可能遇到的问题及应对策略。

快速在 Windows 上搭建 Jekyll 开发环境

发布于 2018-03-04 05:30 更新于 2018-08-12 06:50

Jekyll 是一个不错的静态博客工具，本文将提供快速在 Windows 系统上搭建 Jekyll 开发环境的方法。

---

For 老手

其实所需的命令只有少数几个而已：

代码语言：javascript代码运行次数：0运行复制

# 全局命令：安装 Ruby 所需的依赖ridk install# 全局命令：安装 Jekyllgem install jekyll bundler# 工作目录命令：安装博客仓库中所需的依赖bundle install# 工作目录命令：将本地博客仓库跑起来jekyll serve

For 新手下载必要的软件

考虑到我们的网络环境，为了提升本文的阅读效率，建议一边下载一边阅读。我为大家提供两种不同的下载源：1. 官方源；2. 加速源。

官方源 Ruby（挑最新的下载即可）MSYS2（虽然这不是必要的，但能大大提高配置环境的成功率和速度）加速源（感谢小伙伴林德熙） rubyMSYS2安装 Ruby 和 Jekyll 分别安装下载好的 Ruby 和 MSYS2 安装包，一路下一步，直到两者都安装结束； 一般安装完 Ruby 后会自动弹出一个新的命令行安装界面，我们需要在里面选择 3，然后回车。

如果上一步没有提前下载安装 MSYS2，那么这里会因为众所周知的网络原因速度奇慢无比，或者以失败告终。如果没有弹出命令行安装界面或者把它关掉了，那么也可以在任意的命令行中输入 ridk install 来再次进入命令行安装界面。如果网络状况良好，能够一次装成功。（如果不幸失败。则一直再次选 3 继续安装直到全部成功为止。） Install MSYS2 and MINGW development toolchain succeeded

再打开一个新的命令行窗口（cmd/powershell/bash/msys2 都行），输入以下命令安装 jekyll： gem install jekyll bundler

自此，Jekyll 开发环境就搭建完成了。

让自己的博客跑起来

如果你已经有了自己的 Jekyll 博客，希望在本地能够编译运行，那么就继续阅读本节。

可能你的博客来源于这些地方：

从 Jekyll Themes 挑选并下载了一款主题；克隆了自己或别人的博客站点，准备改改自己用；

那么我们开始。首先在博客的根目录打开命令行，接下来的操作都在命令行中。

安装依赖包 bundle install 将 Jekyll 服务跑起来 jekyll serve

这就完成了！

不过，如果上述第 2 个步骤发生了错误，通常是依赖包的版本不匹配所致，运行命令更新依赖包：

代码语言：javascript代码运行次数：0运行复制

bundle update

随后再次 jekyll serve 即可。

Ruby 跨版本升级的坑

如果你之前安装过 Ruby 的旧版本，现在需要跨大版本号升级，那么你会遇到很多问题：

ruby 命令对应新旧哪个版本是不明确的如果你覆盖安装了 ruby，那么之前安装自动设置的那些环境变量（例如 gem）就会丢失

这会导致你试图编译你的博客时遇到各种各样奇怪的错误。

所以，你需要做的是：

卸载掉之前的 ruby再次安装 ruby

本文会经常更新，请阅读原文： https://walterlv.com/post/setup-jekyll-in-windows.html ，以避免陈旧错误知识的误导，同时有更好的阅读体验。

本作品采用 知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议 进行许可。欢迎转载、使用、重新发布，但务必保留文章署名 吕毅 （包含链接： https://walterlv.com ），不得用于商业目的，基于本文修改后的作品务必以相同的许可发布。如有任何疑问，请 与我联系 (walter.lv@qq.com) 。

今天关于《Windows上Jekyll开发环境快速搭建攻略》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于Ruby,Windows,依赖包,Jekyll,MSYS2的内容请关注golang学习网公众号！