PhpStorm 2026.1 Help

エンコーディング

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

2026 年 5 月 22 日