WebStorm 2026.1 Help

エンコーディング

ファイルを正しく表示・編集するには、WebStorm で使用するエンコーディングを認識する必要があります。 ソースコードファイルは通常、UTF-8 でエンコードされます。 他の要件がない限り、これが推奨されるエンコードです。

ファイルのエンコーディングを決定するために、WebStorm は次の手順を使用します:

  • バイトオーダーマーク (BOM)が存在する場合、WebStorm は他のすべての設定に関係なく、対応する Unicode エンコーディングを使用します。 詳細については、 バイト順マーク(英語)を参照してください。

  • ファイルがエンコーディングを明示的に宣言している場合、WebStorm は指定されたエンコーディングを使用します。 例: これは XML または HTML ファイルに適用できます。 明示的な宣言は他のすべての設定も上書きしますが、エディターで変更できます。

  • ファイルに BOM がなく、明示的なエンコーディング宣言がない場合、WebStorm は ファイルエンコーディング設定 でファイルまたはディレクトリに設定されたエンコーディングを使用します。 ファイルまたはディレクトリにエンコーディングが設定されていない場合、WebStorm は親ディレクトリのエンコーディングを使用します。 親ディレクトリのエンコーディングも設定されていない場合、WebStorm は プロジェクトエンコーディング にフォールバックし、プロジェクトがない場合は グローバルエンコーディング にフォールバックします。

明示的なエンコーディングを含むファイルのエンコーディングを変更する

  1. エディターで目的のファイルを開きます。

  2. 明示的なエンコーディング情報を変更します。 エラーハイライトを使用して間違ったエンコーディングを認識し、 Ctrl+Space を押すと使用可能なエンコーディングのリストが表示されます。

    明示的エンコード

ファイルの表示に使用されるエンコーディングを変更する

WebStorm がファイル内の文字を正しく表示しない場合は、ファイルのエンコーディングを検出できなかった可能性があります。 この場合、このファイルの表示と編集に使用する正しいエンコードを指定する必要があります。

  1. エディターでファイルを開きます。

  2. ステータスバーファイルエンコーディング ウィジェットをクリックします。

    または、メインメニューから ファイル | ファイルプロパティ | ファイルエンコーディング を選択します。

  3. 正しいエンコーディングを選択してください。

    ステータスバーのエンコード

    三角形の警告アイコン または 丸いエラーアイコン でマークされたエンコーディングは、ファイルの内容を変更する可能性があります。 この場合、WebStorm はファイルの処理方法を選択できるダイアログを開きます:

    • 再ロード: ディスクからエディターにファイルをロードし、エンコードの変更をエディターのみに適用します。 選択したエンコーディングに関連するコンテンツの変更が表示されますが、実際のファイルは変更されません。

    • 変換: 選択したエンコーディングでファイルを上書きします。

これにより、ファイルの関連付けが ファイルエンコーディング設定に追加されます。 WebStorm は、指定されたエンコーディングを使用してこのファイルを表示および編集します。

プロパティファイルのデフォルトのエンコードを設定する

WebStorm はシステムのデフォルトエンコーディングを properties ファイル に適用します。 他のエンコーディングを使用するには、エスケープシーケンスと Unicode として指定してください。 または、プロジェクトレベルで .properties ファイルのデフォルトエンコーディングを定義し、定義したエンコーディングで .properties ファイルを読み込むことができる別の API を使用してください。

  1. 設定 ダイアログ(Ctrl+Alt+S )で、 エディター | ファイルエンコーディング を選択します。

  2. 次のいずれかを実行します:

    • シンボルがエスケープシーケンスとしてプロパティファイルに保存されているが、通常の文字として表示される場合に特殊モードをオンにするには、オプション 透過的なネイティブから ASCII への変換 をオンにします。 このオプションは、プロパティファイルが ISO 8859-1 でエンコードされている場合に役立ちます。 エンコードを変更する特別な理由がない場合は、このアプローチを使用することをお勧めします。

    • プロパティファイルのデフォルトエンコーディング リストで、プロジェクト内のすべてのプロパティファイルに使用されるエンコーディングを選択します。

ファイルのエンコード設定を構成する

  • Ctrl+Alt+S を押して設定を開き、 エディター | ファイルエンコーディング を選択します。

WebStorm はこれらの設定を使用して、エンコーディングを検出できなかったファイルの表示や編集を行い、新しいファイルには指定されたエンコーディングを使用します。 詳細は、 ファイルエンコーディング を参照してください。

コンソール出力エンコーディングを選択する

デフォルトでは、WebStorm はシステムエンコーディングを使用してコンソール出力を表示します。

  1. 設定 ダイアログ(Ctrl+Alt+S )で、 エディター | 一般 | コンソール を選択します。

  2. デフォルトエンコード リストからデフォルトのエンコーディングを選択します。

  3. 変更を適用するには、 OK をクリックします。

コンソール出力設定の詳細については、「コンソール 」を参照してください。

2026 年 6 月 8 日