ファイルを Git に追加し、変更を追跡する

Git にファイル追加

コミットツールウィンドウ（Alt+0 ）を開きます。
Ctrl+Alt+A を押すか、コンテキストメニューから VCS に追加を選択して、バージョン管理外ファイル変更リスト内のファイルをバージョン管理下に置きます。変更リスト全体を追加することも、個別のファイルを選択することもできます。

プロジェクトで Git 統合を有効にしている場合、PyCharm は新しく作成した各ファイルをバージョン管理下に追加することを提案します。この動作は、バージョン管理 | 確認の設定ダイアログ Ctrl+Alt+S で変更できます。特定のファイルを常にバージョン管理しないようにしたい場合は、無視するように Git を構成できます。

誤って Git にファイルを追加した場合、現在のところ、その追跡を停止する単一のアクションはありません。

ファイルがまだコミットされていない場合は、コミットツールウィンドウ（Alt+0 ）を開き、ファイルを右クリックしてロールバックを選択します（または Ctrl+Alt+Z を押します）。追加されたファイルのローカルコピーを削除するチェックボックスが選択されていないことを確認してください。
ファイルがすでにコミットされている場合は、次の回避策を使用できます。設定 | バージョン管理 | 確認に移動し、ファイル作成時を追加しないに設定します。必要なファイルをプロジェクト外に保存し、現在のプロジェクトから削除して、プロジェクトフォルダーに戻してください。

ファイルはその後、コミットツールウィンドウ（Alt+0 ）のバージョン管理外ファイルノードに表示されます。

今後このような事故を防ぐために、このファイルを右クリックして .gitignore に追加するを選択し、 .gitignore に追加することができます。

プロジェクトファイルのステータスを確認する

PyCharm を使用すると、ローカル作業コピーのステータスをプロジェクトのリポジトリバージョンと比較して確認できます。どのファイルが変更されたか、どの新しいファイルが Git に追加されたか、どのファイルが Git によって追跡されていないかを確認できます。

コミットツールウィンドウ（Alt+0 ）を開きます。

変更リストには、リモートリポジトリと最後に同期してから変更されたすべてのファイル (青色でハイライト) と、Git に追加されたがまだコミットされていないすべての新しいファイル (緑色でハイライト) が表示されます。
バージョン管理外ファイル変更リストには、あなたのプロジェクトに追加されたが、Git によって追跡されていないすべてのファイルが表示されます。

バージョン管理機能ツールウィンドウのローカルの変更タブから、ファイルやフォルダーのアップロードやデプロイ済みバージョンとの比較などのデプロイタスクを直接実行できます。これを行うには、項目を右クリックして、コンテキストメニューからデプロイを選択します。次に、サブメニューから目的のアクションを選択します。

エディターでファイルへの変更を追跡する

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

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

一部に色と意味を強調リストのデフォルトの線下表のカラースキーム。

色	回線状況	説明
#C3D6E8	変更された行	最後の更新以降に変更された行。
#EDDCBC	空白が変更された行	最後の更新以降に空白のみが変更された行。
#C9DEC1	追加された行	最後の更新以降に追加された行。
#9F9F9F	削除された行	前回の更新以降に削除された行。

色	回線状況	説明
#374752	変更された行	最後の更新以降に変更された行。
#4C4638	空白が変更された行	最後の更新以降に空白のみが変更された行。
#384C38	追加された行	最後の更新以降に追加された行。
#656E76	削除された行	前回の更新以降に削除された行。

色	回線状況	説明
#1AABFF	変更された行	最後の更新以降に変更された行。
#666666	空白が変更された行	最後の更新以降に空白のみが変更された行。
#009924	追加された行	最後の更新以降に追加された行。
#FFA14F	削除された行	前回の更新以降に削除された行。

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

をクリックして変更をロールバックし、をクリックして現在の行の現在のバージョンとリポジトリバージョンの違いを確認できます。

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

ファイルの状態を確認する

PyCharm を使用すると、リポジトリに対するプロジェクトファイルのステータスを確認できます。ファイルステータスには、前回リポジトリと同期してからファイルに対して実行された操作が表示されます。

ファイル名をハイライトする色によって、任意のインターフェース要素（例：エディターやツールウィンドウ）でファイルのステータスを確認できます。

色とフォント設定ページでファイルステータスのデフォルトの色をカスタマイズできます。

バージョン管理 | ファイルステータスの色設定ページ Ctrl+Alt+S で VCS ファイルのステータスの色を設定できます。

以下の表は、いくつかのカラースキームにおけるデフォルトのファイルステータスの色とその意味を示しています。

色	ファイルステータス	説明
#0A7700	追加済み	アクティブな変更リストのファイルは、リポジトリへの追加がスケジュールされています。
#0EAA00	非アクティブ変更リスト内の追加対象	非アクティブ変更リスト内のファイルは、リポジトリへの追加が予定されています。このファイルステータスは、設定 \| バージョン管理 \| 変更リストで非アクティブな変更リストのファイルをハイライトするオプションが有効になっている場合に利用可能です。
#FF0000	変更リストの競合	非アクティブな変更リスト内のファイルがアクティブな変更リスト内で変更されます。この場合、新しいダイアログが開き、変更リストの競合を解決するように求められます。このファイルステータスは、設定 \| バージョン管理 \| 変更リストですべてのオプションが有効になっている場合に使用できます。
#0A7700	コピー	ファイルが別のファイルのコピーである場合、そのメタデータが追跡され、そのようなファイルはコピー済みとしてマークされます。
#616161	削除	ファイルはリポジトリから削除される予定です。
#773895	ファイルシステムから削除	ファイルはローカルで削除されましたが、削除がスケジュールされておらず、リポジトリ内にまだ存在しています。
#8AA4C8	変更された子孫あり	ファイルが変更されると、IDE はそのファイルを含むすべてのディレクトリを再帰的にハイライトします。このステータスは、設定 \| バージョン管理 \| 確認でプロジェクトツリー内の変更ファイルを含むディレクトリをハイライトするオプションが有効になっている場合に利用可能です。
#3264B4	即時変更された子あり	ファイルが変更されると、IDE はその親ディレクトリをハイライトします。このステータスは、設定 \| バージョン管理 \| 確認でプロジェクトツリー内の変更ファイルを含むディレクトリをハイライトするオプションが有効になっている場合に利用可能です。
#B28C00	ハイジャック	[Perforce, ClearCase, VSS] ファイルはチェックアウトせずに変更されています。
#727238	無視	ファイルは VCS によって意図的に追跡されていません。
#7503DC	マージ済み	ファイルはアップデートの結果として VCS によってマージされます。
#FF0000	競合がある状態でマージされています	最後の更新中に、ファイルは競合とマージされました。
#FF0000	プロパティ競合のマージ	前回の更新中に、IDE はローカルファイルのプロパティとそのサーバーバージョンの違いを検出しました。
#FF0000	テキストおよびプロパティ競合のマージ	テキストとプロパティの競合は、2 人以上の開発者がファイルの同じ行と同じファイルプロパティを変更すると発生します。
#0032A0	変更	最後の同期以降にファイルが変更されました。
#0047E4	非アクティブな変更リストで変更	無効な変更リスト内のファイルが変更されます。このファイルステータスは、設定 \| バージョン管理 \| 変更リストで非アクティブな変更リストのファイルをハイライトするオプションが有効になっている場合に利用可能です。
#7C7C00	廃止	このファイルはもうリポジトリの作業コピーに含まれていないはずです。
#007C7C	名前変更	最後の更新以降、ファイルの名前は変更されました。
#08978F	切り替え	[SVN] ファイルは、プロジェクト全体とは異なるブランチから取得されます。
#993300	（不明）バージョン管理外	ファイルはローカルに存在しますが、リポジトリには存在せず、追加はスケジュールされていません。
なし (デフォルトの色)	最新	ファイルは変更されていません。

色	ファイルステータス	説明
#629755	追加済み	アクティブな変更リストのファイルは、リポジトリへの追加がスケジュールされています。
#629755	非アクティブ変更リスト内の追加対象	非アクティブ変更リスト内のファイルは、リポジトリへの追加が予定されています。このファイルステータスは、設定 \| バージョン管理 \| 変更リストで非アクティブな変更リストのファイルをハイライトするオプションが有効になっている場合に利用可能です。
#D5756C	変更リストの競合	非アクティブな変更リスト内のファイルがアクティブな変更リスト内で変更されます。この場合、新しいダイアログが開き、変更リストの競合を解決するように求められます。このファイルステータスは、設定 \| バージョン管理 \| 変更リストですべてのオプションが有効になっている場合に使用できます。
#0A7700	コピー	ファイルが別のファイルのコピーである場合、そのメタデータが追跡され、そのようなファイルはコピー済みとしてマークされます。
#6C6C6C	削除	ファイルはリポジトリから削除される予定です。
#6C6C6C	ファイルシステムから削除	ファイルはローカルで削除されましたが、削除がスケジュールされておらず、リポジトリ内にまだ存在しています。
#6897BB	変更された子孫あり	ファイルが変更されると、IDE はそのファイルを含むすべてのディレクトリを再帰的にハイライトします。このステータスは、設定 \| バージョン管理 \| 確認でプロジェクトツリー内の変更ファイルを含むディレクトリをハイライトするオプションが有効になっている場合に利用可能です。
#6897BB	即時変更された子あり	ファイルが変更されると、IDE はその親ディレクトリをハイライトします。このステータスは、設定 \| バージョン管理 \| 確認でプロジェクトツリー内の変更ファイルを含むディレクトリをハイライトするオプションが有効になっている場合に利用可能です。
なし (デフォルトの色)	ハイジャック	[Perforce, ClearCase, VSS] ファイルはチェックアウトせずに変更されています。
#848504	無視	ファイルは VCS によって意図的に追跡されていません。
#9876AA	マージ済み	ファイルはアップデートの結果として VCS によってマージされます。
#D5756C	競合がある状態でマージされています	最後の更新中に、ファイルは競合とマージされました。
#D5756C	プロパティ競合のマージ	前回の更新中に、IDE はローカルファイルのプロパティとそのサーバーバージョンの違いを検出しました。
#D5756C	テキストおよびプロパティ競合のマージ	テキストとプロパティの競合は、2 人以上の開発者がファイルの同じ行と同じファイルプロパティを変更すると発生します。
#6897BB	変更	最後の同期以降にファイルが変更されました。
#6897BB	非アクティブな変更リストで変更	無効な変更リスト内のファイルが変更されます。このファイルステータスは、設定 \| バージョン管理 \| 変更リストで非アクティブな変更リストのファイルをハイライトするオプションが有効になっている場合に利用可能です。
なし (デフォルトの色)	廃止	このファイルはもうリポジトリの作業コピーに含まれていないはずです。
#3A8484	名前変更	最後の更新以降、ファイルの名前は変更されました。
なし (デフォルトの色)	切り替え	[SVN] ファイルは、プロジェクト全体とは異なるブランチから取得されます。
#D1675A	（不明）バージョン管理外	ファイルはローカルに存在しますが、リポジトリには存在せず、追加はスケジュールされていません。
なし (デフォルトの色)	最新	ファイルは変更されていません。

色	ファイルステータス	説明
#62CC47	追加済み	アクティブな変更リストのファイルは、リポジトリへの追加がスケジュールされています。
#62CC47	非アクティブ変更リスト内の追加対象	非アクティブ変更リスト内のファイルは、リポジトリへの追加が予定されています。このファイルステータスは、設定 \| バージョン管理 \| 変更リストで非アクティブな変更リストのファイルをハイライトするオプションが有効になっている場合に利用可能です。
#FF6666	変更リストの競合	非アクティブな変更リスト内のファイルがアクティブな変更リスト内で変更されます。この場合、新しいダイアログが開き、変更リストの競合を解決するように求められます。このファイルステータスは、設定 \| バージョン管理 \| 変更リストですべてのオプションが有効になっている場合に使用できます。
#62CC47	コピー	ファイルが別のファイルのコピーである場合、そのメタデータが追跡され、そのようなファイルはコピー済みとしてマークされます。
#ED864A	削除	ファイルはリポジトリから削除される予定です。
#ED864A	ファイルシステムから削除	ファイルはローカルで削除されましたが、削除がスケジュールされておらず、リポジトリ内にまだ存在しています。
#4FF0FF	変更された子孫あり	ファイルが変更されると、IDE はそのファイルを含むすべてのディレクトリを再帰的にハイライトします。このステータスは、設定 \| バージョン管理 \| 確認でプロジェクトツリー内の変更ファイルを含むディレクトリをハイライトするオプションが有効になっている場合に利用可能です。
#4FF0FF	即時変更された子あり	ファイルが変更されると、IDE はその親ディレクトリをハイライトします。このステータスは、設定 \| バージョン管理 \| 確認でプロジェクトツリー内の変更ファイルを含むディレクトリをハイライトするオプションが有効になっている場合に利用可能です。
なし (デフォルトの色)	ハイジャック	[Perforce, ClearCase, VSS] ファイルはチェックアウトせずに変更されています。
#A9B837	無視	ファイルは VCS によって意図的に追跡されていません。
#ED94FF	マージ済み	ファイルはアップデートの結果として VCS によってマージされます。
#FF6666	競合がある状態でマージされています	最後の更新中に、ファイルは競合とマージされました。
#FF6666	プロパティ競合のマージ	前回の更新中に、IDE はローカルファイルのプロパティとそのサーバーバージョンの違いを検出しました。
#FF6666	テキストおよびプロパティ競合のマージ	テキストとプロパティの競合は、2 人以上の開発者がファイルの同じ行と同じファイルプロパティを変更すると発生します。
#4FF0FF	変更	最後の同期以降にファイルが変更されました。
#4FF0FF	非アクティブな変更リストで変更	無効な変更リスト内のファイルが変更されます。このファイルステータスは、設定 \| バージョン管理 \| 変更リストで非アクティブな変更リストのファイルをハイライトするオプションが有効になっている場合に利用可能です。
なし (デフォルトの色)	廃止	このファイルはもうリポジトリの作業コピーに含まれていないはずです。
#4FF0FF	名前変更	最後の更新以降、ファイルの名前は変更されました。
なし (デフォルトの色)	切り替え	[SVN] ファイルは、プロジェクト全体とは異なるブランチから取得されます。
D1675A	（不明）バージョン管理外	ファイルはローカルに存在しますが、リポジトリには存在せず、追加はスケジュールされていません。
なし (デフォルトの色)	最新	ファイルは変更されていません。

リポジトリからファイルを削除する

バージョン管理下にあるファイルを削除しても、変更をコミットするまで、そのファイルはリポジトリに存在し続けます。削除されたファイルはアクティブな変更リストに配置され、灰色でハイライトされます。

Project ツールウィンドウ（Alt+1 ）でファイルを選択し、 Delete を押すか、コンテキストメニューから削除を選択します。
表示されるダイアログで、使用方法を検索せずにこのファイルを削除するか、安全な削除オプションをチェックして安全な削除を実行する (未使用のファイルを確実に削除するため) かを選択できます。
使用箇所が見つかった場合は、検出された使用箇所ダイアログがポップアップ表示され、使用箇所がリストされます。ファイルを削除する前に、これらの使用箇所を表示し、このファイルへの参照を削除できます。
リポジトリへの変更をコミットします。

2026 年 6 月 1 日