トラブルシューティング
i1n CLI、SDK、ダッシュボードの使用中に発生する一般的なエラーや問題の解決策。
i1n: コマンドが見つかりません
このエラーは、i1n CLIがグローバルにインストールされていないか、PATHに含まれていないことを意味します。インストールするには、npm install -g i1n を実行してください。バージョンマネージャー(nvm、fnm)を使用している場合は、グローバルなbinディレクトリがPATHに含まれていることを確認してください。
macOS/Linuxでは、which i1nコマンドでインストールパスを確認できます。bunを使用している場合は、代わりにbun install -g i1nを実行してください。
APIキーが無効か、認証エラーが発生しました
i1n.config.json内のAPIキーが見つからない、期限切れ、または無効な場合に発生します。dashboard.i1n.aiの組織設定から新しいキーを生成し、i1n initを実行して再設定してください。
プロジェクトを所有する組織に対して正しいAPIキーを使用していることを確認してください。各組織には独自のキーがあります。ある組織のキーでは、別の組織のプロジェクトにアクセスすることはできません。
i1nプッシュが失敗するか、キーをスキップします
i1n pushがキーをゼロ件返すかファイルをスキップする場合、i1n.config.jsonの設定とロケールディレクトリおよびファイル形式が一致していることを確認してください。必要に応じて再設定するには、i1n initを実行してください。
一般的な原因としては、無効なグロブパターン、ファイル形式の不一致(例:ネストされたJSONが構成されている場合にフラットなJSON)、または空の翻訳ファイルが挙げられます。
i1n pull は空のファイルを生成します
これは通常、プロジェクトにサーバー上の翻訳がないことを意味します。最初にi1n pushを実行してソースキーをアップロードし、次にi1n pullを実行して翻訳をダウンロードしてください。
キーをプッシュしたのにプルで空のファイルが返される場合は、ターゲット言語がプロジェクトに追加されているか、i1n add-languageを使用するかダッシュボード経由で確認してください。
i1nプル後のTypeScriptエラー
プル後にIDEでエラーが表示される場合は、i1n.d.tsがTypeScriptコンパイルに含まれていることを確認してください。CLIはtsconfig.jsonを自動的に更新しますが、手動設定の調整が必要な場合があります。
i1n.d.tsは毎回i1n pullで再生成されるため、直接編集しないでください。ファイルが破損しているように見える場合は、削除して再度i1n pullを実行してください。