Intlayer コマンドが未定義

概要

Intlayer CLI は、辞書の構築や翻訳のプッシュなど、intlayer コンテンツを便利に管理する方法を提供します。しかし、プロジェクトの動作に必須ではありません。Next.js 向けの withIntlayer() や Vite 向けの intlayer() のようなバンドラープラグインを使用している場合、Intlayer はアプリのビルド時や開発サーバーの起動時に自動的に辞書を構築します。開発モードでは、変更を監視し、コンテンツ宣言ファイルを自動的に再構築します。

intlayer コマンドには以下の方法でアクセスできます：

intlayer CLI コマンドを直接使用する
VSCode 拡張機能を使用する
@intlayer/cli SDK を使用する

問題

intlayer コマンドを使用しようとすると、次のエラーが発生することがあります：

'intlayer' は、内部コマンドまたは外部コマンド、操作可能なプログラムまたはバッチ ファイルとして認識されていません。

解決策

以下の順番で解決策を試してください：

コマンドがインストールされているか確認する

npx intlayer -h

期待される出力：

Usage: intlayer [options] [command]Intlayer CLIOptions:    -V, --version            バージョン番号を出力    -h, --help               コマンドのヘルプを表示Commands:    dictionary|dictionaries  辞書操作    configuration|config     設定操作    help [command]           コマンドのヘルプを表示

Usage: intlayer [options] [command]Intlayer CLIOptions:    -V, --version            バージョン番号を出力    -h, --help               コマンドのヘルプを表示Commands:    dictionary|dictionaries  辞書操作    configuration|config     設定操作    help [command]           コマンドのヘルプを表示

intlayer-cli パッケージをグローバルにインストールする

npm install intlayer-cli -g -g

すでに intlayer パッケージをインストールしている場合は、これを行う必要はありません

パッケージをグローバルにインストールする

npm install intlayer -g

ターミナルを再起動する
新しいコマンドを認識させるために、ターミナルの再起動が必要な場合があります。
クリーンアップして再インストールする
上記の解決策がうまくいかない場合は：

rm -rf node_modules package-lock.jsonnpm install

インストールファイルを確認する
問題が解決しない場合は、以下のファイルが存在するか確認してください：
- node_modules/intlayer/dist/cjs/cli.cjs
- node_modules/intlayer/package.json （bin フィールドが ./dist/cjs/cli.cjs を参照している必要があります）
PATH 環境変数を確認する
npm のグローバル bin ディレクトリが PATH に含まれていることを確認してください：

# Unix系システム（macOS/Linux）の場合echo $PATH# /usr/local/bin や ~/.npm-global/bin のようなパスが含まれている必要があります# Windowsの場合echo %PATH%# npmのグローバルbinディレクトリが含まれている必要があります

# Unix系システム（macOS/Linux）の場合echo $PATH# /usr/local/bin や ~/.npm-global/bin のようなパスが含まれている必要があります# Windowsの場合echo %PATH%# npmのグローバルbinディレクトリが含まれている必要があります

npxをフルパスで使用する コマンドがまだ見つからない場合は、npxをフルパスで試してください：

npx ./node_modules/intlayer/ dictionaries build

競合するインストールの確認

# グローバルにインストールされているパッケージを一覧表示npm list -g --depth=0# 競合するグローバルインストールを削除npm uninstall -g intlayernpm uninstall -g intlayer-cli# その後再インストールnpm install -g intlayer

# グローバルにインストールされているパッケージを一覧表示npm list -g --depth=0# 競合するグローバルインストールを削除npm uninstall -g intlayernpm uninstall -g intlayer-cli# その後再インストールnpm install -g intlayer

Node.jsとnpmのバージョン確認 互換性のあるバージョンを使用していることを確認してください：

node --versionnpm --version

古いバージョンを使用している場合は、Node.jsとnpmのアップデートを検討してください。

権限の問題を確認する
権限エラーが発生している場合は、以下を試してください：

# Unix系システムの場合sudo npm install -g intlayer# または npm のデフォルトディレクトリを変更するmkdir ~/.npm-globalnpm config set prefix '~/.npm-global'# ~/.profile または ~/.bashrc に以下を追加：export PATH=~/.npm-global/bin:$PATH

# Unix系システムの場合sudo npm install -g intlayer# または npm のデフォルトディレクトリを変更するmkdir ~/.npm-globalnpm config set prefix '~/.npm-global'# ~/.profile または ~/.bashrc に以下を追加：export PATH=~/.npm-global/bin:$PATH