Shopify CLI执行theme dev报错：无法使用gems及加载指定文件

问题说明 #

通过Homebrew安装了Shopify CLI v3.40.1（Node.js版本），成功初始化Dawn主题并关联店铺，但执行shopify theme dev登录后出现以下错误：

[Note] You cannot use gems with Shopify CLI.
[LoadError] cannot load such file -- listen
       They are disabled.
       Please don't modify the CLI locally.
       ...
[LoadError] cannot load such file -- bugsnag

尝试安装gem时遇到权限错误，即使使用sudo安装后问题依旧。

解决方案 #

1. 清理旧版Ruby版Shopify CLI残留 #

Shopify CLI v3+已完全切换到Node.js架构，不再依赖Ruby gems，错误原因大概率是系统中存在旧版Ruby版CLI的残留：

• 卸载Ruby版CLI：

  gem uninstall shopify-cli
  

• 删除CLI配置目录（建议先备份再操作）：

  rm -rf ~/.shopify-cli
  

2. 重新安装Node.js版Shopify CLI #

• 卸载现有Homebrew安装的CLI：

  brew uninstall shopify-cli
  

• 清理Homebrew缓存：

  brew cleanup
  

• 重新安装官方Node.js版CLI：

  brew tap shopify/shopify && brew install shopify-cli
  

• 验证版本（确认输出开头为@shopify/cli/，即Node.js版）：

  shopify --version
  

3. 修复Ruby环境权限问题（避免后续干扰） #

不要使用系统自带Ruby，推荐用版本管理器搭建独立Ruby环境，彻底解决权限问题：

• 安装rbenv：

  brew install rbenv
  

• 安装最新稳定版Ruby：

  rbenv install 3.2.2
  

• 设置全局Ruby版本：

  rbenv global 3.2.2
  

• 重启终端后验证环境：

  ruby --version
  gem --version
  

4. 重置CLI会话与项目配置 #

• 登出当前关联的Shopify店铺：

  shopify logout
  

• 删除项目目录下的CLI本地配置文件：

  rm .shopify-cli.yml
  

• 重新执行开发命令并完成授权：

  shopify theme dev
  

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