GoLand 2024.1 ヘルプ

使用箇所を検索

コードを記述または編集するときに、変更または削除するコード要素に遭遇する場合があります。変更を行う前に、コード要素がどこで使用され、アプリケーションにどのように影響するかを確認することをお勧めします。使用箇所の検索アクションを使用すると、コードベース全体でコード要素の参照を検索できます。

検索プロセスを管理し、単一のファイルのみで検索したり、検索をプロジェクト全体に拡張したり、特定の検索範囲を作成したりできます。さらに、使用箇所のハイライトの色を構成したり、用途の自動ハイライトを完全に無効にしたりできます。

ファイル内の使用箇所を検索する

  • エディターで、検索するシンボルを選択します。GoLand は、ファイルで見つかったすべての使用箇所を自動的にハイライトします。使用箇所のハイライトが無効になっている場合は、Ctrl+Shift+F7 を押して、ファイル内のすべての使用箇所をハイライトします。

    Find usages in file result
  • 編集 | 使用箇所の検索 | ファイル内で使用箇所の検索 Ctrl+F7 に進みます。GoLand は、ファイル内の最初の使用箇所を選択します。

    Find usages result

F3 および Shift+F3 ショートカットを使用して、ハイライトされたシンボル間を移動します。

プロジェクトの使用箇所を検索する

  • 使用箇所を検索する記号を選択し、記号を右クリックして、コンテキストメニューから使用箇所の検索を選択するか、Alt+F7 を押します。(Alt+F7)を押すと、GoLand はインターフェースメソッドの使用箇所を探します。現在の方法の使用箇所を見つけるには、Ctrl+Alt+Shift+F7 を押します。

    検索ツールウィンドウで結果を確認します。

    必要に応じて、結果をファイル、パッケージ、ディレクトリなどでグループ化(the Group By icon)できます。

    GoLand は検索結果を分析し、最も一般的な使用パターンを検出し、見つかったすべての使用を構造上の類似性に基づいてグループに分類します。これらの使用クラスタは、プレビュータブに表示されます。

    リストから任意のグループノードを選択し、類似の使用箇所を表示をクリックして結果を確認できます。

    この機能を無効にするには、詳細設定使用箇所の検索ビューで類似した使用箇所のクラスター化を有効化の選択を解除します。

    Find tool window preview area

見つかった使用箇所のソースコードをプレビューする

見つかった使用箇所のコードソースを表示するには、いくつかのオプションがあります。

  1. 使用箇所を検索するシンボルを選択し、シンボルを右クリックして、コンテキストメニューから使用箇所の検索を選択するか、Alt+F7 を押します。

  2. 検索ツールウィンドウで、ソースのプレビューアイコンをクリックします。

    Preview source code for found usages

    別の方法として、見つかった使用箇所でコンテキストメニューを呼び出す場合はソースに移動を選択するか、分割して表示を選択できます。この場合、結果の使用箇所を含むファイルがエディターで開かれます。

別のウィンドウに使用箇所を表示する

選択したシンボルの使用箇所を別のウィンドウで表示できます。このウィンドウは、画面のさまざまな部分に移動して、クイックナビゲーションに使用できます。

  1. エディターで、使用箇所を表示するシンボルを選択します。

  2. 編集 | 使用箇所の検索 | コードでの使用箇所を表示 Ctrl+Alt+F7 に進みます。

    Show Usages results window

    使用箇所ウィンドウには、現在のスコープと使用箇所の総数が表示されます。デフォルトのスコープにすばやく切り替えたい場合は、Ctrl+Alt+F7 を押します。

    検索結果のエントリが多すぎる場合、GoLand は最初に見つかった 100 の使用箇所と、ウィンドウの下部にクリックしてさらに 100 の使用箇所を表示できる追加の使用箇所オプションを表示します。

    ウィンドウ上部のフィルターを使用して、特定の検索エントリを表示または非表示にします。

最近の使用箇所の検索結果を表示する

GoLand は使用箇所の検索の結果を記憶しているため、アクションを再度実行する必要はありません。

  • メインメニューで編集 | 検索 | 最近の使用箇所を検索に移動し、使用箇所クエリを選択します。

使用箇所の検索のスコープを管理する

場合によっては、プロジェクトの特定のファイルまたはライブラリでのみ使用箇所を見つけたい場合があります。

  1. Ctrl+Alt+Shift+F7 を押して使用箇所の検索ダイアログを開きます。

    Ctrl+Alt+Shift+F7 を押すと、現在のメソッドの使用箇所を探します。インターフェースメソッドの使用箇所を探すには、Alt+F7 を押します。

  2. 使用箇所の検索ダイアログのスコープフィールドで、検索の範囲を選択します。例: 開いているファイルまたは最近変更したファイルのみで使用箇所を検索できます。

    Find Usages dialog (Change Scope)

    the ellipsis icon をクリックして、カスタムスコープを設定することもできます。例: カスタムスコープを作成して、テストファイルなどの特定のファイルを使用箇所の検索から除外できます。新しいスコープの設定が完了したら、検索をクリックします。

  3. GoLand が結果を返さない場合、より多くのオプションを選択することを提案するメッセージが表示されます。

    No usages found popup

    リンクをたどるか、Ctrl+Alt+Shift+F7 を押して使用箇所の検索ダイアログを再度開き、検索の新しいスコープを設定できます。

使用箇所の自動ハイライトを無効にする

キャレットをシンボルに配置すると、IDE は現在のファイルでこのシンボルのすべての使用箇所をハイライトします。

必要に応じて、自動ハイライトを無効にすることができます。

  1. Ctrl+Alt+S を押して設定を開き、エディター | コード編集を選択します。

  2. キャレット移動のハイライトセクションのキャレット上の要素の使用箇所チェックボックスをオフにします。

自動ハイライトが無効になっていて、現在のファイル内のシンボルの使用箇所をハイライトする場合は、この記号を選択して Ctrl+Shift+F7 を押します。これにより、現在のファイル内のシンボルのすべての使用箇所がハイライトされます。

ハイライトされた使用箇所の背景色を変更する

  1. 設定ダイアログ(Ctrl+Alt+S)で、エディター | カラースキームの切り替え | 一般に移動します。

  2. 右側のオプションから、コードノードを開き、キャレットの識別子を選択します。

  3. バックグラウンドフィールドで、必要な色を指定し、変更を保存します。

基本メソッドまたはメソッドの実装を検索する

メソッドの使用箇所を検索すると、GoLand は、基本メソッドまたはメソッドの実装のどちらを検索するかを選択するように求めます。

今後この質問を表示しないチェックボックスを選択すると、GoLand はプロンプトを表示しなくなり、選択した検索オプションがデフォルトとして使用されます。必要に応じて、プロンプトを復元できます。

  1. 設定ダイアログ(Ctrl+Alt+S)で、エディター | 一般 | スマートキーに移動します。

  2. PHP 領域で、メソッドの使用箇所を検索するときに追加のオプションを表示するチェックボックスを選択します。

生産性のヒント

ディレクトリの使用箇所を表示する

  • プロジェクトツールウィンドウ(表示 | ツールウィンドウ | プロジェクト)で、ディレクトリを右クリックして、このディレクトリが使用されている場所を確認します。

    the Find Usages action is available in the context menu in the Project tool window