You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Windows 10 Pro N下多次安装Jekyll失败,已检查环境变量求助

Jekyll安装失败解决指南

环境信息

Windows 10 Pro N
ruby 3.0.6p216 [x64-mingw32]
gem 3.2.33
gcc version 13.1.0 (Rev7, Built by MSYS2 project)
GNU Make 4.4.1

已尝试操作

  • gem cleanup
  • gem list jekyll
  • dir D:/develop/ruby/Ruby30-x64/bin
  • setx PATH "%PATH%;D:\develop\ruby\Ruby30-x64\bin"

安装失败截图

Jekyll安装失败界面

解决步骤

  1. 调整Ruby版本
    Jekyll 4.3+与Ruby 3.0.x存在兼容问题,建议更换为Ruby 2.7.x或3.1.x版本。重新安装时务必勾选添加Ruby可执行文件到系统PATH的选项。

  2. 更换Gem源
    国内网络环境下默认Gem源易访问失败,执行以下命令替换为国内镜像:

    gem sources --remove https://rubygems.org/
    gem sources --add https://gems.ruby-china.com/
    gem sources -l # 确认仅保留国内源
    
  3. 补全编译依赖
    打开Ruby配套的MSYS2终端(开始菜单Ruby文件夹内的"MSYS2 MinGW 64-bit"),安装编译所需依赖:

    pacman -S mingw-w64-x86_64-gcc mingw-w64-x86_64-make mingw-w64-x86_64-libxml2 mingw-w64-x86_64-libxslt
    
  4. 强制重装Jekyll
    清理残留组件后重新安装:

    gem uninstall jekyll bundler
    gem install jekyll bundler --verbose --platform=ruby
    
  5. 修复PATH环境变量
    打开系统环境变量设置,直接在"Path"中添加D:\develop\ruby\Ruby30-x64\bin,而非使用setx(该命令可能存在生效延迟或权限限制)。设置完成后重启命令提示符验证。

  6. 以管理员权限执行安装
    右键命令提示符选择“以管理员身份运行”,再执行安装命令,避免因权限不足导致的文件写入失败。

内容的提问来源于stack exchange,提问作者Jutta

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.07.14 10:22:30