Shopify theme init やshopify theme devがCommand not foundになります。

日本語 ディスカッション 技術的なQ＆A

Topic summary

Shopify初心者がローカルでテーマ作成を試みる際、shopify theme initとshopify theme devコマンドが「Command not found」エラーで実行できない問題が発生。

環境:

  • Windows 11
  • Node.jsをVoltaで管理
  • npm install -g @shopify/cli @shopify/themeでグローバルインストール済み
  • shopify versionは正常に表示

原因:
Voltaでグローバルインストール（-gオプション使用）した場合、Shopify CLIが@shopify/themeを正しく認識できない。nvmを使用している環境では問題が発生していないため、Voltaの検索パスに関する問題と推測される。

解決方法:
作業ディレクトリ内で-gオプションを付けずにローカルインストールを実行:

  • パッケージがnode_modules直下に配置される
  • shopify commandsでtheme関連コマンドが表示されるようになる
  • shopify theme initとshopify theme devが正常に動作することを確認済み
Summarized with AI on November 19. AI used: claude-sonnet-4-5-20250929.
1

shopify初心者です。
ご回答いただけると幸いです。

▼問題
公式ドキュメント を参考にローカルで自作テーマを作成したいのですが、shopify theme 系のコマンドがどれも機能しません。
npm install -g @Shopify_77 /cli @Shopify_77 /themeを実行し、shopify versionでバージョン確認まで済ませています。

▼環境
windows11
Node.js: 18.16.0（voltaで管理）
Ruby: 3.2.2（MSYS2選択済み）
Git: 2.41.0
Bundler: 2.4.13
Shopify CLI: 3.46.3

▼状況
・shopify theme initを実行すると「? Command theme init my-theme not found. Did you mean kitchen-sink async?」と表示されます。
・shopify theme devを実行すると「Command ‘theme dev’ not found.」と表示されます。

2

WSL2+Ubuntu20.04で少し異なりますが、同様にVoltaで管理している環境で発生することを確認しています。

-[email removed]

このとき、shopify [email removed]

nvmを使っている環境では発生していないので、

shopify CLIの検索パスを何らかの方法で改善できれば解決するかもしれません。

-gをつけずにテーマ作成用のワーキングディレクトリにインストールすると、

直下のnode_modulesに入ります。

shopify commandsでtheme関連が表示されるようになり、shopify themeも動きます。

ローカルにインストールする方法が正しいかわかりませんが、

作成を進められると思いますのでご確認ください。

1 Like
3

ご回答ありがとうございます！
送っていただいた内容の通り、-gをつけないコマンドでshopify CLIを再インストールしたところ、theme initとtheme devに成功できました。

本当にありがとうございます。