共享主机安装Jekyll主题失败求助：找不到Jekyll gem报错

核心原因分析 #

你遇到的Gem::GemNotFoundException是因为系统找不到虚拟环境中安装的Jekyll，大概率是虚拟环境激活不彻底、安装路径错误或命令执行位置不对导致的。

分步解决办法 #

• 确认虚拟环境正确激活
  cPanel创建的Ruby虚拟环境路径带有双下划线前缀，比如/home/你的用户名/rubyvenv/jekyll_site/__20240501_1234/，必须执行正确的激活命令：

  source /home/你的用户名/rubyvenv/jekyll_site/__[你的双下划线目录名]/bin/activate
  

  激活成功后终端提示符会显示(jekyll_site)，此时所有gem操作才会指向这个虚拟环境。

• 重新在虚拟环境内安装依赖
  激活环境后，直接执行以下命令安装Bundler和Jekyll，不要进入public_html目录：

  gem install bundler jekyll
  

  执行gem list检查输出，确认jekyll和bundler已出现在列表中。

• 在正确目录执行jekyll new
  你通过cPanel创建的应用目录是jekyll_site，进入该目录后执行初始化命令（加--force覆盖已有文件）：

  cd /home/你的用户名/jekyll_site
  jekyll new . --force
  

• 排查全局Ruby冲突
  执行which jekyll，如果输出是/home/你的用户名/bin/jekyll，说明调用的是全局Ruby的Jekyll，而非虚拟环境内的。先卸载全局版本：

  gem uninstall jekyll
  

  然后回到虚拟环境重新安装Jekyll即可。

内容的提问来源于stack exchange，提问作者Varonne