PyCharm 2024.2 ヘルプ

プロジェクトを作成する

プロジェクトを作成したら、新しい項目の追加を開始できます。新しいディレクトリ、パッケージ、ファイルを作成したり、既存のファイルやフォルダーを追加したりできます。

新規項目の作成

新規ファイルを作成する

  1. 以下のいずれか 1 つを実行します:

    • プロジェクトツールウィンドウ (Alt+1) で、新しいファイルを作成するディレクトリまたはパッケージを選択し、メインメニューからファイル | 新規を選択します。

    • ディレクトリまたはパッケージを右クリックし、コンテキストメニューから新規を選択します。

    • ディレクトリを選択し、Alt+Insert を押します。

  2. 目的のファイルタイプを選択します。一般に、ファイルパッケージディレクトリを除くすべてのオプションは、ファイルテンプレートの使用に対応しています。

    New file menu

    既存のファイルテンプレートが、ファイル名拡張子 (テンプレート拡張子) が認識されたファイルタイプのいずれかの登録パターンと一致しないカスタムテンプレートである場合、リストに表示されない可能性があります。このような場合、認識されている既存のファイルタイプに対応するパターンを登録するか、新しいファイルタイプを追加して、この新しいタイプに対応するパターンを登録することができます。詳細については、ファイルタイプの関連付けを参照してください。

  3. 開いたダイアログで、対応するフィールドにファイルの名前を入力します。ファイル名拡張子を入力しないでください。

    Adding a new Python file

    新しいファイル名の前にディレクトリ構造全体を指定できます。ネストしたディレクトリがまだ存在しない場合は、作成されます。

    New file in specified directory

    必要に応じて、新しいテンプレートベースのファイルの種類、拡張子、その他のパラメーターを指定します。例: HTML ファイルを作成する場合は、HTML、HTML4、XHTML ファイルを作成できます。つまり、対応する関連ファイルテンプレートの 1 つを使用します。

    必要に応じてその他の情報を指定します。例: 対応するファイルテンプレートにそのような変数が含まれていて、その値が現在設定されていない場合は、カスタム変数の値を定義するように求められます。

  4. OK をクリックします。選択したファイルテンプレートに対応する新しいファイルがターゲット場所に作成されます。

    存在しないサブディレクトリの名前が新しいファイル名の前に指定された場合、構造全体がターゲットディレクトリに作成されます。

    New file

    場合によっては、自動生成されたファイル名拡張子を変更したいことがあります。それには、Rename リファクタリングリファクタリング | 名前の変更)を使用してください。

ディレクトリを作成する

  1. プロジェクトツールウィンドウ(表示 | ツールウィンドウ | プロジェクトなど)を開きます。

  2. 宛先ディレクトリを選択します。

  3. 以下のいずれか 1 つを実行します:

    • ファイル | 新規 | ディレクトリを選択します。

    • コンテキストメニューから新規 | ディレクトリを選択します。

    • Alt+Insert を押してディレクトリを選択します。

    Create a directory
  4. 表示されたダイアログで、ディレクトリ名を指定します。多数のネストされたディレクトリを作成する場合は、ディレクトリ名をスラッシュで区切って指定します。

    New Directory dialog

    Enter を押してタスクを完了します。

PyCharm は、Python パッケージを再帰的に作成することができるため、パッケージ構造全体を作成できます。

Python パッケージのノードには、package アイコンが付けられています。

Python パッケージを作成する

  1. プロジェクトツールウィンドウで、コピー先ディレクトリを選択します。

  2. 選択のコンテキストメニューから新規 | Python パッケージを選択するか、Alt+Insert を押してコンテキストメニューを表示します。

    Create a package
  3. 開いた新規パッケージダイアログで、パッケージ名を指定します。

    ネストされたパッケージを指定することもできます。この場合、名前はドットで区切る必要があります。

    package name

    OK をクリックします。PyCharm は新しいパッケージまたはパッケージ構造を作成します:

    generate package

パッケージを作成したため、次のことができます。

同じディレクトリからのインポートが確実に解決されるようにする場合は、そのディレクトリを名前空間パッケージ(英語)としてマークします。

ディレクトリを名前空間パッケージとしてマークする

  1. 同じディレクトリにある lib1lib2 の 2 つのパッケージについて考えてみます。lib1 インポートステートメントを lib2.py に含めるようにしてください。PyCharm は、パッケージ外の相対インポートを報告します。

    Relative import outside of the package
  2. インポートを解決して警告を回避するには、mydir ディレクトリを名前空間パッケージとしてマークします。次のオプションがあります。

    • キャレットをインポートステートメントに配置し、Alt+Enter を押して(または黄色のバルブをクリックして)、対応するクイックフィックスを適用します。

    • プロジェクトツールウィンドウでディレクトリを右クリックし、ディレクトリをマーク | 名前空間パッケージを選択します。

既存のアイテムを追加する

次のいずれかのオプションを使用して、既存のファイルとフォルダーをプロジェクトに追加できます。

  • システムファイルマネージャーから項目をプロジェクトツールウィンドウ (Alt+1) のノードにドラッグします。

  • システムファイルマネージャーで項目をコピーし、IDE プロジェクトツールウィンドウのノードに貼り付けます。

  • システムファイルマネージャーで、アイテムをプロジェクトフォルダーに手動で移動します。

    関連ページ:

    プロジェクトツールウィンドウ

    プロジェクトツールウィンドウを使用すると、さまざまな視点からプロジェクトを確認し、新しい項目 (ディレクトリ、ファイル、クラスなど) の作成、エディターでのファイルのオープン、必要なコードフラグメントへの移動などのさまざまなタスクを実行できます。このツールウィンドウのほとんどの機能には、コンテンツペインのコンテキストメニューコマンドとして、関連するショートカットを介してアクセスします。このビューには、作成されたスクラッチファイル、クエリコンソール、拡張スクリプトを管理できるスクラッチとコンソール...

    ファイルタイプの関連付け

    PyCharm は、さまざまな言語やテクノロジを表すファイルの言語固有の機能(構文のハイライトやコード分析など)について、ファイルタイプのリストを保持します。各ファイルタイプは、言語サービスを 1 つ以上のファイル名パターンにリンクします。ファイルタイプのデフォルトリストには、関連するすべてのファイル名パターンが含まれていますが、カスタム言語ファイルに新しいファイルタイプを追加したり、既存のファイルタイプに関連付けられたファイル名パターンを変更したりできます。エディターでファイルを開くと、PyC...

    名前の変更リファクタリング

    名前変更リファクタリングを使用して、コード全体でシンボル、ファイル、変数、関数、パッケージ、モジュール、それらへのすべての参照の名前を変更します。限定されたスコープのみが影響を受けるため、ローカル変数または関数の名前変更はインラインで簡単に実行できます。クラスまたはそのメソッドの名前を変更すると、多くのファイルに影響を与える可能性があります。リファクタリングする前に、潜在的な変更をプレビューします。コード要素の名前をインラインで変更する名前を変更する要素にキャレットを置き、を押します。コメント

    Git リポジトリに変更をコミットしてプッシュする

    Git リポジトリに新しいファイルを追加するか、すでに Git バージョン管理下にあるファイルを変更し、現在の状態に満足したら、作業の結果を共有できます。これには、ローカルにコミットしてリポジトリのスナップショットをプロジェクト履歴に記録し、次にリモートリポジトリにプッシュして他のユーザーが使用できるようにすることが含まれます。Git ユーザー名を設定する Git は、コミットを ID に関連付けるために、ユーザー名を知っている必要があります。ユーザー名を設定していない場合、PyCharm は、最...

    LightEdit モード

    PyCharm でプロジェクト全体を作成またはロードせずに 1 つのファイルのみを編集する必要がある場合は、LightEdit モードを使用できます。LightEdit モードはテキストのようなエディターとして機能し、コード補完やコードナビゲーションなどの通常の IDE エディター機能をサポートしていないことに注意してください。ただし、特定のコード行に移動したり、コードの一部を折りたたんだり展開したり、ファイルエンコーディングを確認したり、変更したりすることはできます。LightEdit モードで...

    プロジェクトを開く、再開、閉じる

    初めてプロジェクトを開くと、ウェルカム画面が表示されます。ディスクからプロジェクトを開くか、バージョン管理システムからダウンロードできます。プロジェクトを開く:ディスクからプロジェクトを開く以下のいずれか 1 つを実行します: に移動します。ウェルカム画面で、オープンをクリックします。、開いたファイルまたはプロジェクトを開くダイアログで、目的のプロジェクトディレクトリの場所を見つけます。PyCharm プロジェクトはでマークされ、他の IDE または専用エディターで作成されたプロジェクトはでマー...