PyCharm 2020.3 ヘルプ

ファイルの差分ビューアー

プロジェクトツールウィンドウ | ファイルのコンテキストメニュー | エディターでファイルを比較
プロジェクトツールウィンドウ | ファイルのコンテキストメニュー | ファイルを比較
バージョン管理 / コミットツールウィンドウ | ローカルの変更タブ | Icons actions diff
バージョン管理ツールウィンドウ | フォルダーまたはファイルのコンテキストメニュー | 差分を表示

このダイアログは、2 つのファイルまたは 2 つのバージョンのファイルを比較するときに表示されます(ローカルの変更、またはローカルファイルとリモートリポジトリのリビジョン間の変更)。バイナリや .jar ファイルなど、あらゆるタイプのファイルを比較できます。ダイアログを開くには、比較する 2 つのファイルまたはそのバージョンを比較するファイルを選択して、Ctrl+D を押します。

差分ビューアーは、コード補完、ライブテンプレート、その他の機能を有効にする強力なエディターを提供します。

ビューの差分とマージ

項目 ツールチップとショートカット 説明
the Previous Difference button / the Next Difference button 前の違い / 次の違い Shift+F7 F7undefined

次または前の違いにジャンプします。

差分ビューアーの設定最後の変更の後に次のファイルに移動するオプションに応じて、最後または最初の違いに達すると、PyCharm は矢印ボタン F7 / Shift+F7 をもう一度クリックして他のファイルを比較することを提案します。

この動作は、差分ビューアーコミットツールウィンドウ Alt+0 から呼び出された場合にのみサポートされます。

the Back button
the Forward button
前 / 次のファイルを比較
Alt+Left Alt+Right

前または次のファイルのローカルコピーをサーバーからの更新と比較します。

the Go To Changed File button 変更されたファイル Ctrl+N にジャンプ 現在の変更セット内の変更されたすべてのファイルを表示し、それらに移動します。このボタンは、複数のファイルの変更を確認する場合にのみ使用できます。例:ローカルの変更ビュー。
the Jump to Source button ソースにジャンプ
F4
選択したファイルをエディターのアクティブペインで開きます。キャレットは差分ビューアーと同じ位置に配置されます。
ビューアー

ビューアーモードを選択します:サイドバイサイドまたは統合。サイドバイサイドモードには 2 つのパネルがあり、統合モードには 1 つのパネルがあります。

両方のビューアーでコードを編集し、適用追加元に戻すアクションを実行できます。

テキストを変更できるのは、サイドバイサイドビューアーの右側の部分か、統合ビューアーの下部の行のみです。

ファイルのローカルバージョンのみを編集できます。読み取り専用ステータスのファイルは編集できません。

空白

差分ビューアーが空白を処理する方法を定義します。

  • 無視しない : 空白は重要であり、すべての違いがハイライトされています。このオプションはデフォルトで選択されています。

  • 空白をトリム : 空白が行の最後と先頭にある場合は空白を削除します(("\t", " "))。

    • 2 行の末尾の空白のみが異なる場合、これらの行は等しいと見なされます。

    • 2 行が異なる場合、末尾の空白は単語モードでハイライトされません。

  • ホワイトスペースを無視 : 空白は、ソースコード内の場所に関係なく、重要ではありません。

  • 空白と空行を無視 : 空白と空行を無視します。次のエンティティは無視されます。

    • すべての空白 (「ホワイトスペースを無視する」オプションのように)

    • 空白のみで構成される追加または削除されたすべての行

    • 空白以外の部分を変更せずに、行を分割または結合することで構成されるすべての変更。
      例: a b ca \n b c の違いは、このモードではハイライトされません。

ハイライトモード

差分の粒度がハイライトされる方法を選択します。

利用可能なオプションは以下のとおりです。

  • 変更された単語をハイライト : 変更された単語がハイライトされます

  • 変更行をハイライト : 変更された行がハイライトされます

  • 分割された変更をハイライト : このオプションを選択すると、大きな変更が小さな変更に分割されます。

    例: A \n B および A X \n B X は、1 つではなく 2 つの変更として扱われます。

  • シンボルをハイライトする : 変更されたシンボルがハイライトされます

  • ハイライトしない : このオプションを選択した場合、違いはまったくハイライトされません。

    大幅に変更されたファイルを操作する場合は、ハイライトしないオプションを使用します。そのような場合、ハイライトすると、レビュー中にさらに困難が生じる可能性があります。

the Collapse All button 変更されていないフラグメントを縮小 両方のファイルのすべての変更されていないフラグメントを折りたたみます。折りたたみできない変更されていない行の量は、差分 & マージ設定ページで構成できます。差分 & マージページを開くには、Ctrl+Alt+S を押して設定を開き、ツール | 差分 & マージに移動します。
the Synchronize button スクロールの同期 このボタンをクリックして、両方の差分ペインを同時にスクロールします。このボタンを離すと、各ペインを個別にスクロールできます。
the Settings button 設定

利用可能な設定のリストを開きます。

これらのコマンドは、差分ビューアーガターのコンテキストメニューからも利用できます。

コミット Alt+I に含める

このチェックボックスは、複数の変更されたファイル(すべてが選択解除されている)を使用して変更のコミットダイアログから差分ビューアーを起動し、それらの差分を調べてファイルの最後の差分にヒットした場合にのみ表示されます。

確認したファイルをコミットに含める場合は、このチェックボックスを選択します。

the Help button F1 のヘルプ ブラウザーを開き、対応するヘルプページを表示します。
Ctrl+Tab 差分ビューアーのペインを切り替えます。アクティブなペインにはカーソルがあります。
apply left apply right

ペイン間(サイドバイサイドビューアーの場合)または行間に(統合ビューアーの場合)差分を適用します。

シェブロンボタンは、その動作を変更することができます:

  • apply left およびapply rightをクリックして、変更を適用します。この動作はデフォルトです。

  • Ctrl を押してapply leftまたはapply rightchevron button bottom right またはchevron button bottom leftに変更し、変更を追加します。

マージアクション
compare options button 該当なし

このアイコンをクリックすると、異なるバージョンのファイルを比較して競合を解決できるオプションのリストが表示されます。

ベースは、ローカルバージョンとリポジトリバージョンが由来するファイルバージョン(最初は中央のペインに表示されます)を参照し、垂直方向の中央は結果バージョンを参照します。
the Apply Non-Conflicting Changes button すべての非競合変更を適用 このボタンをクリックすると、矛盾しないすべての変更が適用されます。また、設定 / 環境設定ダイアログの Diff&Merge ページのチェックボックス競合しない変更を自動的に適用するを選択することで、この動作を自動化することもできます。
Apply Non-Conflicting Changes from the Left/Right 左右から競合しない変更を適用する これらのボタンをクリックすると、競合しない変更がダイアログの左 / 右部分からマージされます。
GitBlame で注釈を付ける

このオプションはガターのコンテキストメニューからのみ利用可能です。

このオプションを使用して、誰がいつファイルのリポジトリバージョンに変更を加えたかを調べます。注釈ビューでは、コードの各行の詳細情報(この行の元のバージョン、この行をコミットしたユーザーの ID、コミット日など)を確認できます。

注釈の詳細については、VCS 注釈を参照してください。

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

キーボードショートカットの入力 説明
このキーボードショートカットを使用して、最も一般的に使用される diff コマンドのポップアップメニューを表示します。
Ctrl+Tab このキーボードショートカットを使用して、左右のペインを切り替えます。
Ctrl+Shift+Tab このキーボードショートカットを使用して、反対側のペインで Ctrl+Tab によって取得された位置を選択します。
Ctrl+Z / Ctrl+Shift+Z このキーボードショートカットを使用して、マージ操作を元に戻す / やり直すことができます。衝突はテキストと同期され続けます。

コンテキストメニューコマンド

このコンテキストメニューは、エディターの中央で使用できます。

項目 説明
空白を表示 このチェックコマンドを選択すると、差分ビューアーの点として空白を表示します。
行番号の表示 このチェックコマンドを選択すると、差分ビューアーに行番号が表示されます。
インデントガイドを表示 インデントの位置を示すために、PyCharm が Differences ビューアーに垂直線を表示するようにするには、このチェックコマンドを選択します。
ソフトラップを使用 ダイアログのサイズ変更時に PyCharm がコード行を折り返すようにするには、このチェックコマンドを選択します。
ハイライトレベル このメニュー項目を使用して、差分ビューアーのハイライトレベルを選択します。ハイライトのレベルについて詳しくは、ファイルのハイライトレベルを変更するを参照してください。
注釈 変更に注釈付けるには、このチェックコマンドを選択します。

このコンテキストメニューは、両方のエディターで使用できます。

項目 説明
承認 / 追加 これらのコマンドを選択して、差分ビューアーに表示される行を受け入れるか追加します
クリップボードと比較 差分ビューアーのそれぞれのペインにあるファイルをクリップボードの内容と比較するには、このコマンドを選択します。
注釈 変更に注釈付けるには、このチェックコマンドを選択します。

このコンテキストメニューは、Differences ビューアーの右側のストリップで利用できます。

項目 説明
優先度の高い問題のみに進む / 次の問題に進む これらのラジオボタンの 1 つをクリックして、発生した問題の間をナビゲートする方法を定義します。
ハイライトレベルのカスタマイズ クリックすると、差分ビューアーのハイライトレベルを変更するためのスライダが表示されます
スクロールバーのホバーにコードレンズを表示する スクロールバーの上にマウスを移動したときに、差分ビューアーの表示領域外にコードを表示できるようにします。

生産性のヒント

2 つの SQL クエリを比較する

クリップボードの内容を SQL クエリの選択部分と比較できます。

  1. SQL クエリをクリップボードにコピーします。

  2. クリップボードのクエリと比較するエディターでクエリを選択して右クリックします。クエリを選択せずに、クリップボードの内容をファイル全体と比較します。

  3. コンテキストメニューからクリップボードと比較を選択します。