Intlayer コマンドが未定義

    概要

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

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

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

    問題

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

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

    解決策

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

    1. コマンドがインストールされているか確認する
    bash
    npx intlayer -h

    期待される出力：

    bash
    Usage: intlayer [options] [command]Intlayer CLIOptions:    -V, --version            バージョン番号を出力    -h, --help               コマンドのヘルプを表示Commands:    dictionary|dictionaries  辞書操作    configuration|config     設定操作    help [command]           コマンドのヘルプを表示
    1. intlayer-cli パッケージをグローバルにインストールする
    bash
    npm install intlayer-cli -g -g
    すでに intlayer パッケージをインストールしている場合は、これを行う必要はありません
    1. パッケージをグローバルにインストールする
    bash
    npm install intlayer -g

    1. ターミナルを再起動する
      新しいコマンドを認識させるために、ターミナルの再起動が必要な場合があります。

    2. クリーンアップして再インストールする
      上記の解決策がうまくいかない場合は：

    bash
    rm -rf node_modules package-lock.jsonnpm install

    1. インストールファイルを確認する
      問題が解決しない場合は、以下のファイルが存在するか確認してください：

      • node_modules/intlayer/dist/cjs/cli.cjs
      • node_modules/intlayer/package.json （bin フィールドが ./dist/cjs/cli.cjs を参照している必要があります）

    2. PATH 環境変数を確認する
      npm のグローバル bin ディレクトリが PATH に含まれていることを確認してください：

    bash
    # Unix系システム（macOS/Linux）の場合echo $PATH# /usr/local/bin や ~/.npm-global/bin のようなパスが含まれている必要があります# Windowsの場合echo %PATH%# npmのグローバルbinディレクトリが含まれている必要があります
    1. npxをフルパスで使用する コマンドがまだ見つからない場合は、npxをフルパスで試してください：
    bash
    npx ./node_modules/intlayer/ dictionaries build
    1. 競合するインストールの確認
    bash
    # グローバルにインストールされているパッケージを一覧表示npm list -g --depth=0# 競合するグローバルインストールを削除npm uninstall -g intlayernpm uninstall -g intlayer-cli# その後再インストールnpm install -g intlayer
    1. Node.jsとnpmのバージョン確認 互換性のあるバージョンを使用していることを確認してください：
    bash
    node --versionnpm --version
    plaintext
    古いバージョンを使用している場合は、Node.jsとnpmのアップデートを検討してください。
    1. 権限の問題を確認する
      権限エラーが発生している場合は、以下を試してください：
    bash
    # Unix系システムの場合sudo npm install -g intlayer# または npm のデフォルトディレクトリを変更するmkdir ~/.npm-globalnpm config set prefix '~/.npm-global'# ~/.profile または ~/.bashrc に以下を追加：export PATH=~/.npm-global/bin:$PATH