PhpStorm 2024.3 ヘルプ

エディターのガター

ガターは、エディターの左側にある垂直の領域です。ガターには、コード作業中に簡単にアクセスできる重要な情報とアクションアイコンが表示されます。ガターの外観と動作は、好みに応じてカスタマイズできます。

Editor gutter

小さい画面で作業し、ガターやその他の UI 要素が占めるスペースを少なくしたい場合は、コンパクトモードを有効にすることができます。

スクリーンリーダーを使用する場合は、行番号、アノテーション、アイコンツールヒントをガターで読み取るように設定できます。

行数

デフォルトでは、ガターに行番号が表示されるため、チームメイトと話し合ったり、コード内を移動したりするときに、特定のコード行を参照しやすくなります。

行番号を設定する

必要に応じて、複数の行番号モードを切り替えることができます。

  1. 設定ダイアログ(Ctrl+Alt+S)を開き、エディター | 一般 | 外観に移動します。

  2. 行番号の表示オプションを有効にして、ドロップダウンメニューから必要な行番号モードを選択します。

    ファイルの上から下まで順番に実行される標準の行番号付けで、各行に一意の番号が与えられます。このモードは、直接移動したり、ディスカッションやエラーメッセージ内の特定の行を参照したりする場合に役立ちます。

    Absolute line numbering

    行番号は、各行がキャレットの現在の位置から何行離れているかを示します。これは、キーボードショートカットを使用してコードブロックをすばやく移動または編集する場合に特に便利です。

    Relative line numbering

    このモードでは、絶対行番号と相対行番号が組み合わされ、キャレットの現在の位置には絶対行番号が表示され、他のすべての行には相対行番号が表示されます。これにより、両方のシステムの利点を活用して、効率的なナビゲーションと編集が可能になります。

    Hybrid line numbering

行番号を非表示

行番号を非表示にするには、次のいずれかを実行します。

  • ガターを右クリックして、外観 | 行番号の表示の選択を解除します。

  • 設定ダイアログで、エディター | 一般 | 外観に移動し、行番号の表示オプションのチェックを外します。

コードの折りたたみ

手元のタスクに合わせてコードの表示をカスタマイズするには、コード折りたたみを使用できます。デフォルトでは、マウスをホバーすると、展開された領域のガターのアイコンが表示されます。

Code folding

折りたたみアイコンを常に表示するには、設定 | エディター | 一般 | コードの折りたたみに移動し、コードの折りたたみの矢印を表示するの横にある常時を選択します。

折りたたみアイコンを常に非表示にするには、設定 | エディター | 一般 | コードの折りたたみに移動して、コードの折りたたみの矢印を表示するチェックボックスをオフにします。

Action のアイコン

使用可能なガターアイコンのリストは、プロジェクトの構成、使用するフレームワーク、インストールしたプラグインによって異なります。例: アクションアイコンは、クラスの実装とオーバーライドメソッドを追跡したり、アプリケーションを実行したりするために使用できます。

プロジェクトで使用できるガターアイコンのリストにアクセスするには、設定 | エディター | 一般 | ガターアイコンに移動します。

ガターのアイコンを表示または非表示にするには、その横にあるチェックボックスをオンまたはオフにします。すべてのガターアイコンを無効にする場合は、リストの上部にあるガターアイコンを表示チェックボックスをオフにします。

Gutter icons settings in the Settings dialog

ブックマーク

ブックマークは、特定のコード行をマークして、後ですぐに移動できるようにするために使用されます。

匿名の行ブックマークを追加する

  • エディターで、キャレットをコード行に配置し、F11 を押します。

  • または、ブックマークするコード行の横にあるガターを右クリックして、ブックマークの追加を選択します。

ブックマークされた行の横のガターにブックマークアイコンが表示されます。

Anonymous bookmark placed in the editor

ニーモニック行ブックマークを追加する

  1. エディターで、キャレットをコード行に配置し、Ctrl+F11 を押します。

    または、ブックマークするコード行の横にあるガターを右クリックして、ニーモニックのブックマークを追加を選択します。

  2. 開いたポップアップで、このブックマークの識別子として使用する数字または文字を選択します。

    Adding a mnemonic bookmark: select an identifier

    選択したニーモニックがすでに使用されている場合、IDE は、既存のブックマークを新しいブックマークで上書きするかどうかを確認します。ニーモニックをサイレントに上書きするには、今後このメッセージを表示しないオプションを選択します。

  3. 必要に応じて、新しいブックマークの説明を入力します。

  4. Enter を押すか、選択した文字または数字をもう一度クリックして、ブックマークを保存します。

    文字または数字のブックマークアイコンが、ブックマークされた行の横のガターに表示されます。

実行とデバッグ

エディターのガターは、テストの実行やコードのデバッグに便利なエントリポイントとして機能します。

  • テストを実行またはデバッグするには、エディターで関連するテストファイルを開き、テストの横にあるガターアイコンの the Run icon をクリックして、リストから実行 '<test name>' またはデバッグ '<test name>' を選択します。

    Run single test from the editor

Gutter を使用すると、ブレークポイントを管理することもできます。

ブレークポイントの管理

  • 行ブレークポイントを設定するには、実行可能なコード行のガターをクリックします。

  • メソッドブレークポイントを設定するには、メソッドが宣言されている行のガターをクリックします。

  • 例外以外のブレークポイントを削除するには、ガターでクリックします。

ブレークポイントアイコンを設定する

デフォルトでは、ブレークポイントアイコンは水平方向のスペースを節約するために行番号の上に配置されます。

Breakpoints

行番号の近くにブレークポイントを配置するには、ガターを右クリックし、外観 | 行番号の上にブレークポイントの選択を解除します。

    コードカバレッジ

    コードカバレッジを使用すると、テストでカバーされるコードの量を測定できます。

    エディターでは、コード行はコードカバレッジステータスに応じてガター内で色分けされます。

    • Full code coverage 緑 – 実行された行

    • Full code coverage 赤 – 実行されていない行

    特定のコード行が何回実行されたかを確認したり、エディターからカバレッジ結果を非表示にしたりするには、ガターの色インジケーターをクリックします。

    Coverage results shown in the editor

    バージョン管理

    Git Blame アノテーションを構成する

    VCS アノテーションを使用すると、誰がファイルにどのような変更を加えたかがわかります。

    アノテーションを有効にするには、ガターを右クリックして Git Blame でアノテーションを付けるを選択します。

    Git Blame annotationss

    好みに応じて情報を表示するようにアノテーションを設定できます。

    • アノテーションコンテンツ。アノテーションを右クリックして表示に移動します。アノテーションに含める情報(リビジョン番号、変更日、作成者名)を選択できます。

    • 。アノテーションを右クリックして、表示 | 色に移動します。ハイライトする内容を選択できます。最近のコミットを見やすくするための変更の順序、または変更の作成者。ハイライトを無効にするには、非表示オプションを選択します。

    • 名前。アノテーションを右クリックして表示 | 名前に移動します。作成者のラベル付け方法を選択できます。フルネーム、名のみ、姓のみ、イニシャル、メールを使用できます。

    エディターでファイルを変更したときに、そのファイルへの変更を追跡することもできます。すべての変更は、変更された行の隣のガターに表示される変更マーカーでハイライトされ、最後にリポジトリと同期してから導入された変更の種類を示します。リポジトリに変更をコミットすると、変更マーカーが消えます。

    テキストに加えた変更は色分けされています。

    Highlighting colors for added, changed, and deleted lines

    変更マーカーの上にマウスを移動してクリックすると表示されるツールバーを使用して、変更を管理できます。ツールバーは、変更された行の前の内容を示すフレームとともに表示されます。

    the modified line marker

    the Revert icon をクリックして変更をロールバックし、the Show diff icon をクリックして現在の行の現在のバージョンとリポジトリバージョンの違いを調べることができます。変更されたフラグメントをハイライトするには、the Highlighting button をクリックします。

    ファイル全体を元に戻す代わりに、このポップアップの内容の一部をコピーしてエディターに貼り付けることができます。

    関連ページ:

    新しい UI

    新しいユーザーインターフェース (UI) は、PhpStorm の外観を新しく再設計したものです。これは、視覚的な複雑さを軽減し、重要な機能に簡単にアクセスできるようにし、必要に応じて複雑な機能を段階的に公開することを目的として作成されており、その結果、見た目も操作性もすっきりします。主な変更点には、簡素化されたメインツールバー、新しいツールウィンドウレイアウト、新しいテーマ、更新されたアイコンがあります。テーマ、アイコン、フォント:新しいライト、ダーク、ライトヘッダー付きライトカラーテーマは...

    アクセシビリティ

    PhpStorm を使用すると、さまざまなユーザー補助機能を使用してニーズに合わせることができます。スクリーンリーダーを使用したり、フォントサイズ、色、特定の UI 要素の動作を調整して、PhpStorm で作業するプロセスを簡単にすることができます。スクリーンリーダーを設定する:PhpStorm は、Windows と macOS の両方でスクリーンリーダーを完全にサポートしています。スクリーンリーダーを有効にするお好みのスクリーンリーダーをダウンロードして有効にします。NVDA: PhpS...

    キーボードショートカット

    PhpStorm には、編集、ナビゲーション、リファクタリング、デバッグ、その他のタスクに関連するほとんどのコマンドに対するキーボードショートカットがあります。これらのホットキーを覚えておくと、キーボードから手を離さずに生産性を高めることができます。すべてのデフォルトのショートカットは構成可能であり、デフォルトではショートカットがないアクションにショートカットを割り当てることもできます。次の表は、最も便利なショートカットをいくつか示しています。ダブルどこでも検索 PhpStorm、プロジェクト、現...

    ソースコードの作成と編集

    コードを使用する場合、PhpStorm は作業にストレスがないことを保証します。追加、選択、コピー、移動、編集、折りたたみ、出現箇所の検索、コードの保存に役立つさまざまなショートカットと機能を提供します。エディター内のナビゲーションについては、エディターの基本を参照してください。ファイルの読み取り専用属性の切り替えファイルが読み取り専用の場合、ステータスバー、エディタータブ、プロジェクトツールウィンドウで、閉じた鍵のアイコンがマークされます。ファイルが書き込み可能である場合、ステータスバーに開い...

    ソースコードナビゲーション

    さまざまなアクションやポップアップを使用して、エディター内のコードをすばやく移動することができます。エディターウィンドウとツールウィンドウ間の移動に関する詳細情報については、エディターの基本を確認してください。PhpStorm で利用可能なナビゲーションオプションをチェックするためにビデオチュートリアルを見ることから始めることができます。キャレットで移動する後方に移動するには、を押します。前方に移動するには、を押します。エディターの上部にすばやく移動するには、を押します。または、を押して

    ブックマーク

    大規模なプロジェクトで作業する場合、ファイルやフォルダーの検索には時間がかかる場合があります。そのような場合、PhpStorm はブックマークを備えています。必要なコード行をブックマークして、見つけやすくすることができます。他のプロジェクトアイテムよりも頻繁に必要なファイルやフォルダーをブックマークすることもできます。すべてのブックマークはブックマークツールウィンドウのリストにグループ化されており、メインメニューからを選択するか、を押すと開くことができます。ツールウィンドウには、コードにブレー...