ローカル履歴

ローカル履歴は、バージョン管理とは関係なく、プロジェクトに加えられたすべての変更を常に追跡できます。

コミット間で行われた違いのみを追跡するバージョン管理システムとは異なり、ローカル履歴にはさらに多くの機能があります。コードの編集、テストの実行、アプリケーションのデプロイなどを行うと、プロジェクトの状態が自動的に記録され、IDE と外部の両方から行われたすべての意味のある変更のリビジョンが維持されます。

ローカル履歴は個人用バージョン管理システムとして動作し、削除したファイルの復元、個別の変更の戻し、プロジェクトにバージョン管理がまだ有効でない場合や、最後のコミット後に不要な変更があった場合でも、ファイルの任意の状態にロールバックできます。また、何も操作する前にコンピューターが予期せず再起動した場合の復元元としても利用できます。

ファイルの変更を復元する

最後のコミット以降、ファイルに一連の変更を加えた後で、重要なコードの一部を削除したことに気付いたと想像してください。この場合、元に戻すアクションでは変更箇所が離れすぎているため役立たず、使用すると他の変更も破棄することになります。

PyCharm なら、数回のクリックでその変更を復元できます。

エディターの任意の場所を右クリックし、コンテキストメニューからローカル履歴 | 履歴の表示を選択します。
開いたダイアログの左側のペインには、現在のファイルの保存されているすべてのリビジョンのリストがタイムスタンプとともに表示されます。右側のペインには差分ビューアーが表示され、各リビジョンとファイルの現在の状態との違いが表示されます。
次のいずれかを実行します：
- ファイル全体をこのリビジョンの状態に戻すには、ファイルを右クリックしてコンテキストメニューから選択範囲とその後の変更を元に戻すを選択するか、ツールバーのをクリックします。
- 特定のコードフラグメントを復元するには、そのフラグメントを含むリビジョンを選択します。右側の差分ビューで、復元するコード部分を見つけて山形ボタンをクリックして、左側のペインからコードをコピーします。

複数のファイルの変更を復元する

1 つのファイルのローカル履歴を表示するのと同様に、フォルダー全体やプロジェクト、複数の個別のファイルについても表示できます。

Project ツールウィンドウ（Alt+1 ）で、履歴を表示したいノードを右クリックするか、ファイルを選択して右クリックし、ローカル履歴 | 履歴の表示を選択します。
元に戻す変更を見つけて、ツールバーのをクリックします。
ツールバーのをクリックして、差分ビューアーで変更を表示します。そこで山形ボタンを使用して、必要な変更を元に戻します。

削除されたファイルを復元する

バージョン管理されていないファイルを誤って削除した場合でも、ローカル履歴を使って復元できます。

Project ツールウィンドウ（Alt+1 ）で削除したファイルが含まれていたノードを選択し、右クリックしてコンテキストメニューからローカル履歴 | 履歴の表示を選択します。
左側で、復元するファイルが含まれているリビジョンを選択し、そのファイルを右クリックして、 Revert Selection を選択します。

特定の状態にラベルを追加する

通常、ローカル履歴のリビジョンにはタイムスタンプが付けられているため、移動するのは簡単ではありません。一部のリビジョンは、事前定義されたイベント (テストの実行、アプリのデプロイ、変更のコミットなど) に基づいてラベルで自動的にマークされます。たとえば、大規模なリファクタリングを開始する直前に、いつでも新しいラベルを追加して、ローカル履歴の現在の状態をマークできます。

メインメニューから File | Local History | Put Label を選択します。
開いたダイアログで、ラベルに意味のある名前を入力し、 OK をクリックします。

ローカル履歴は共有アクセスをサポートしておらず、ローカルに保存されて個人利用のみを想定しています。ただし、特定のリビジョンとの差分が含まれるパッチファイルを作成し、他の人と共有できます。

「ローカル履歴」ダイアログでリビジョンを選択し、ツールバーの「パッチの作成」をクリックします。
開いたダイアログで、新しいパッチの作成方法を指定します。