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

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

For 老手

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

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

For 新手

下载必要的软件

考虑到我们的网络环境，为了提升本文的阅读效率，建议一边下载一边阅读。

如果无法下载，可以考虑 Docker 或者 Windows 上的其他包管理器（如 scoop）。

安装 Ruby 和 Jekyll

分别安装下载好的 Ruby 和 MSYS2 安装包，一路下一步，直到两者都安装结束；
一般安装完 Ruby 后会自动弹出一个新的命令行安装界面，我们需要在里面选择 3，然后回车。
- 如果上一步没有提前下载安装 MSYS2，那么这里会因为众所周知的网络原因速度奇慢无比，或者以失败告终。
- 如果没有弹出命令行安装界面或者把它关掉了，那么也可以在任意的命令行中输入 ridk install 来再次进入命令行安装界面。
- 如果网络状况良好，能够一次装成功。（如果不幸失败。则一直再次选 3 继续安装直到全部成功为止。）
  1 Install MSYS2 and MINGW development toolchain succeeded
再打开一个新的命令行窗口（cmd/powershell/bash/msys2 都行），输入以下命令安装 jekyll：
1 gem install jekyll bundler

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

让自己的博客跑起来

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

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

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

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

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

这就完成了！

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

bundle update

随后再次 jekyll serve 即可。

Ruby 跨版本升级的坑

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

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

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

所以，你需要做的是：

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

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

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