PyCharm 2026.2 Help

プロジェクト設定を共有する

チームが同じ project で作業する場合は設定を共有すると便利ですが、複数のマシンで PyCharm を使用する場合は、 IDE 設定を共有しておくと便利なこともあります。

プロジェクト設定は、プロジェクトディレクトリ内の .idea フォルダー配下の XML ファイルセットに保存されます。 このフォルダーには、バージョン管理下に置かないユーザー固有の設定と、コードスタイル設定など、チームで作業する開発者間で通常共有されるプロジェクト設定の両方が含まれます。

プロジェクトでバージョン管理を有効にすると、PyCharm は個人設定が含まれる workspace.xml ファイルを他の開発者の設定と競合しないように .gitignore リストへ自動的に移動します。

設定ファイルは選択に応じて処理されます。 プロジェクト設定を変更して新しい設定ファイルが作成されると、IDE は画面の下部にこのプロジェクトの設定ファイルの扱い方を選択するように促す通知を表示します。

  • ファイルを表示: 作成された設定ファイルのリストを確認し、バージョン管理下に置くファイルを選択します。 その後、選択したファイルが VCS に追加されるようスケジュールされます。

  • 常に追加: VCS に追加するために .idea ディレクトリに作成されたすべての設定ファイルをサイレントにスケジュールします(現在のプロジェクトにのみ適用されます)。

  • 今後このメッセージを表示しない: 構成ファイルを VCS に追加するようスケジュールしないでください。手動で VCS に追加するまで、それらは バージョン管理対象外 の状況になります(現在のプロジェクトのみに適用されます)。

オプションを選択せずに通知を閉じると、新しい設定ファイルが作成された後に再び表示されます。 IDE を再起動しても、新しいファイルはオプションの 1 つを選択するまでそこにあるリストにも移動します。

設定ファイルの扱い方を選択するよう促す通知

共有できない構成ファイルのリスト

PyCharm は構成ファイルを識別し、無視されるファイルのリストに自動的に追加します。 ただし、プロジェクトを手動で共有している場合は、これらのファイルとフォルダーをバージョン管理下に置かないことをお勧めします。

  • .idea/workspace.xml

  • .idea/usage.statistics.xml

  • .idea/dictionaries フォルダー

  • .idea/shelf フォルダー

ファイルの完全なリストについては、 バージョン管理システムでプロジェクトを管理する方法および JetBrains.gitignore(英語) を参照してください。

Python インタープリターと実行構成を共有する

Python インタープリターのパスは VCS を通じて共有できません。 これらは IDE のインストールごとの構成ディレクトリに保存され、 .idea フォルダーには保存されず、バージョン管理や Settings Sync でも伝播されません。

ただし、インタープリターの表示名は移植可能です。 .idea/misc.xml project-jdk-name を保存し、それぞれの .idea/runConfigurations/*.xml ファイルは SDK_NAME を保存します。 全員が同じコミット名でインタープリターを設定している場合、 .idea/runConfigurations/ ディレクトリを共有できます。

例外は uv 管理インタープリターです。新規登録時に uv が独自の表示名を自動生成し、コミット済みのものを上書きします。

グローバル設定をプロジェクトレベルにコピーする

グローバル (IDE) 設定はプロジェクトとは別に保存されます。 このため、これらの設定はバージョン管理を通じてプロジェクトとともに共有されません。

ただし、一部の設定はプロジェクトレベルにコピーできます。 たとえば、ご自身の コードスタイル構成インスペクションプロファイル のコピーを作成できます。 その場合、IDE は該当する構成ファイルを .idea ディレクトリに作成し、プロジェクトと一緒に VCS で共有できます。

PyCharm は、異なる IDE インスタンス間で設定を共有するための複数の方法も提供しています。 詳細については、 IDE 設定を共有する を参照してください。

2026 年 7 月 14 日