快速在 Windows 上搭建 Jekyll 开发环境-Windows系列-PHP中文网

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

雪夜

发布： 2025-05-10 08:34:10

原创

663人浏览过

快速在 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，然后回车。

再打开一个新的命令行窗口（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 开发环境的详细内容，更多请关注php中文网其它相关文章！