PyCharm 2024.3 ヘルプ

ブックマーク

大規模なプロジェクトで作業する場合、ファイルやフォルダーの検索には時間がかかる場合があります。そのような場合、PyCharm はブックマークを備えています。必要なコード行をブックマークして、見つけやすくすることができます。他のプロジェクトアイテムよりも頻繁に必要なプロジェクトファイルとフォルダーをブックマークすることもできます。

すべてのブックマークはブックマークツールウィンドウのリストにグループ化されており、メインメニューから表示 | ツールウィンドウ | ブックマークを選択するか、Alt+2 を押すと開くことができます。ツールウィンドウには、コードにブレークポイントを配置すると、専用リストに自動的に追加されるすべてのブレークポイントも表示されます。

Bookmarks tool window

PyCharm には、次の 2 種類のブックマークがあります。

  • 匿名のブックマークには識別子がなく、必要な数のブックマークを配置できます。匿名のブックマークでマークされたファイルと行には、ブックマークアイコンがあります。

  • ニーモニックブックマークを使用すると、数字(0 から 9)または文字(A から Z)でブックマークを作成できます。ニーモニックブックマークでマークされたファイルと行には、フレーム内に対応する文字または数字のアイコンがあります。

Adding bookmarks

ブックマークの追加

PyCharm は、自動的に作成され、プロジェクトと同じ名前のブックマークツールウィンドウの事前定義されたリストにブックマークを追加します。さらにリスト作成し、別のリストをデフォルトとして設定できます

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

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

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

    Anonymous bookmark placed in the editor

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

Anonymous bookmark placed in the editor

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

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

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

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

    Adding a mnemonic bookmark: select an identifier

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

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

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

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

ファイルとフォルダーをブックマークする

  1. プロジェクトツールウィンドウ (Alt+1) で、ブックマークする項目を右クリックし、ブックマーク | ブックマークの追加 (F11) またはニーモニックのブックマークを追加 (Ctrl+F11) を選択します。

    複数の項目をブックマークするには、ツールウィンドウで項目を選択し、そのうちの 1 つを右クリックして、ブックマーク | ブックマークの追加 (F11) を選択します。

  2. ニーモニックブックマークの場合は、このブックマークの識別子として使用する数字または文字を選択します。

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

エディタータブをブックマークする

エディタータブからファイルを 1 つずつブックマークできます。これらのブックマークはデフォルトリストに追加されます。

  1. ブックマークするファイルを含むタブを右クリックし、ブックマーク | ブックマークの追加 (F11) を選択して匿名ブックマークを追加するか、ニーモニックのブックマークを追加 (Ctrl+F11) を選択して識別子付きのブックマークを追加します。

  2. ニーモニックブックマークの場合は、このブックマークの識別子として使用する数字または文字を選択します。

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

すべてのエディタータブをブックマークする

開いているすべてのファイルをすばやくブックマークして、これらのブックマークを新しいリストに追加できます。

  1. タブバーにある最近のファイル、タブアクションなどアイコン をクリックし、開いているタブのブックマークを選択します。

  2. 新しいリストに名前を付けます。

    デフォルトでは、このリストを新しいブックマークに使用できます。デフォルトリストとして使用するオプションを有効にします。

    IDE は新しいリストを作成し、開いているタブのすべてのファイルをこのリストに追加します。

    Lists of bookmarks

数字でニーモニックブックマークに移動する

  • Ctrl を押したまま、キーボードのニーモニック数字を押します。

    例: ニーモニック 5 でブックマークに移動するには、Ctrl+5 を押します。

文字で記憶術ブックマークに移動する

デフォルトでは、文字ニーモニックを使用してブックマークに移動するためのショートカットは割り当てられていませんが、カスタムショートカットを設定できます。

  1. Ctrl+Alt+S を押して設定を開き、キーマップを選択します。

  2. ショートカットのリストで、その他 | ブックマーク | 数字 / ニーモニック別に移動を展開し、必要に応じてショートカットを設定します。

  3. 設定されたショートカットを押すと、エディター内の文字のブックマークに移動します。

デフォルトでは、行のブックマークを移動するためのショートカットは割り当てられていませんが、カスタムショートカットを設定できます。

  1. Ctrl+Alt+S を押して設定を開き、キーマップを選択します。

  2. ショートカットのリストで、その他 | ブックマークを展開し、次のショートカットを構成します。

    • 次の行のブックマーク / 前の行のブックマークですべての行のブックマークを移動します。

    • 開いているファイル内のブックマークを移動するには、エディターの次の行のブックマーク / エディターの前の行のブックマークを使用します。

  1. Shift+F11 を押すか、メインメニューで編集 | ブックマーク | 行のブックマークを表示に移動します。

  2. ブックマークをダブルクリックするか、キーボードで選択して Enter を押します。

    ニーモニックブックマークの場合は、対応する数字または文字を押します。

デフォルトでは、PyCharm はブックマークポップアップに行ブックマークのみを表示します。他のブックマークされたアイテム(ファイルやフォルダーなど)を表示するように設定を構成できます。Ctrl+Alt+S を押して IDE 設定を開き、詳細設定を選択して、ポップアップで行のブックマークのみを表示オプションを無効にします。

  1. メインメニューで表示 | ツールウィンドウ | ブックマークに移動するか、Alt+2 を押してブックマークツールウィンドウを開きます。

  2. 目的のブックマークリストを展開するか、すべて展開をクリックしてすべてのリストを展開します。

  3. リスト上のブックマークをダブルクリックして移動するか、次のキーを押します。

    • Ctrl+Alt+Down ( 移動 | 次のブックマーク出現箇所 ) を押すと次のブックマークに移動します。

    • 前のブックマークに戻るには、Ctrl+Alt+Up ( 移動 | 前のブックマーク出現箇所 ) を押します。

ブックマークの変更

ブックマーク名の変更

ブックマークには短い説明があります。デフォルトでは、行のコードまたは配置されているアイテムの名前が含まれています。必要に応じて、ブックマークに独自の短い説明を付けることができます。

  1. Alt を押したまま、エディターのガターにあるブックマークアイコンをクリックします。

    エディターのガターにあるブックマークアイコン、プロジェクトツールウィンドウ内のブックマークされた項目、またはブックマークツールウィンドウ内のブックマークを右クリックして、ブックマーク名の変更を選択することもできます。

  2. 開いたダイアログで、新しい説明を指定し、OK をクリックします。

    Renaming a bookmark

ブックマークツールウィンドウまたはエディターでブックマークの説明を表示できます。ガター内のブックマークアイコンの上にマウスを置くと、ブックマークの説明を含むツールチップが表示されます。

匿名ブックマークにニーモニックを割り当てる

匿名ブックマークをニーモニックブックマークに変換できます。

  1. エディターのガターにあるブックマークアイコン、プロジェクトツールウィンドウ内のブックマークされた項目、またはブックマークツールウィンドウ内のブックマークを右クリックし、ニーモニックの割り当てを選択します (または Ctrl+F11 を押します)。

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

    必要に応じて、説明を入力します。

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

ニーモニック識別子を変更する

  1. エディターのガターにあるブックマークアイコン (プロジェクトツールウィンドウ内のブックマークされた項目) を右クリックして、ニーモニックの変更を選択します (または Ctrl+F11 を押します)。

    Changing a mnemonic identifier for a bookmark
  2. 開いたポップアップで、別の識別子を選択します。必要に応じて、説明も変更してください。

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

ニーモニックブックマークを匿名化する

ニーモニックブックマークを匿名ブックマークに変換できます。

  • エディターのガターにあるブックマークアイコン、プロジェクトツールウィンドウ内のブックマークされた項目、またはブックマークツールウィンドウ内のブックマークを右クリックし、ニーモニックの除去を選択します。

    Anonymizing a mnemonic bookmark from the gutter

ブックマークの削除

  • ブックマークツールウィンドウまたはガターからブックマークを削除するには、ブックマークを右クリックしてブックマークの削除を選択します。

  • プロジェクトツールウィンドウからブックマークを削除するには、ブックマークされた項目を右クリックし、ブックマーク | ブックマークの削除を選択します。

ブックマークのリスト

プロジェクトと同じ名前を持つ、事前定義された空のブックマークリストが 1 つあります。デフォルトでは、PyCharm はそこにブックマークを追加します。必要に応じて、別のリストをデフォルトとして使用できます。複数のリストを作成し、リスト間で項目を移動することもできます。

ブックマークリストを作成する

  1. メインメニューで表示 | ツールウィンドウ | ブックマークに移動するか、Alt+2 を押してブックマークツールウィンドウを開きます。

  2. ツールウィンドウで、Create Bookmarks List をクリックし、開いたダイアログで新しいリストに名前を付けます。

  3. ブックマークをこのリストに自動的に移動させて作成をクリックする場合は、デフォルトリストとして使用するオプションを有効にします。

    Creating new bookmark list

ブックマークを別のリストに移動する

  • 表示 | ツールウィンドウ | ブックマークに移動するか、Alt+2 を押してブックマークツールウィンドウを開き、ブックマークを別のリストにドラッグします。

  • プロジェクトツールウィンドウ (Alt+1) で、ブックマークされた項目を右クリックし、ブックマーク | ブックマークを別のリストに追加を選択します。

ブックマークを並べ替える

  • ブックマークをリストの上下に移動するには、ブックマークツールウィンドウでブックマークを右クリックし、上へ移動または下へ移動を選択します。

  • ファイルごとにグループ化されたツールウィンドウに行ブックマークを表示するには、ブックマークツールウィンドウで Options をクリックし、行のブックマークをファイルごとにグループ化オプションを選択します。

デフォルトリストを変更する

PyCharm は、デフォルトとして設定されているリストにすべてのブックマークを追加します。必要に応じて、ブックマークに別のデフォルトリストを使用できます。

  1. メインメニューで表示 | ツールウィンドウ | ブックマークに移動するか、Alt+2 を押してブックマークツールウィンドウを開きます。

  2. デフォルトのブックマークリストとして使用するリストを右クリックし、リストをデフォルトに設定を選択します。

    これで、リストはツールウィンドウで他のリストの上に配置され、デフォルトタグが付けられます。

    Default list in the Bookmarks tool window

ブックマークのリストを削除する

リストを削除すると、そのリストのすべてのブックマークがコードおよびプロジェクトアイテムから削除されます。

  1. メインメニューで表示 | ツールウィンドウ | ブックマークに移動するか、Alt+2 を押してブックマークツールウィンドウを開きます。

  2. 削除するリストを右クリックして、ブックマークリストの削除を選択します。

関連ページ:

ブレークポイント

ブレークポイントは、特定のポイントでプログラムの実行を一時停止する特別なマーカーです。これにより、プログラムの状態と動作を調べることができます。ブレークポイントは、たとえば、特定のコード行に到達したときにプログラムを一時停止するなどの単純なものから、追加の条件をチェックしたり、ログに書き込んだりするなどのより複雑なロジックを含むものまであります。ブレークポイントは、一度設定すると、一時的なブレークポイントを除き、明示的に削除するまでプロジェクト内に残ります。ブレークポイントの種類:PyChar

ツールウィンドウのスピード検索

スピード検索は、ツールウィンドウ内の項目 (プロジェクトツールウィンドウのファイルまたはフォルダー、構造ツールウィンドウのメンバー、コミットツールウィンドウの変更リスト、TODO リストの項目など) をすばやく検索できます。ツールウィンドウ、ツリー、リスト、ポップアップを選択します。ファイル、クラス、フィールドの名前など、アイテム名の入力を開始します。入力すると、入力した文字を示すフィールドがツールウィンドウ上に表示され、選択範囲が指定した文字列に一致する最初の項目に移動します。文字列の一致する...

ブラウザーの構成

PyCharm には、HTML ファイルの出力の実行、デバッグ、プレビュー中に IDE から自動的にインストールおよび起動できる最も一般的なブラウザーの事前定義リストが付属しています。PyCharm は、標準の手順に従ってブラウザーをインストールすることを前提としており、各インストールに、ブラウザーの実行可能ファイルまたは macOS アプリケーションへのデフォルトパスを表すエイリアスを割り当てます。デフォルトリストのブラウザーに加えて、カスタムブラウザーのインストールを設定できます。PyCha...