PyCharm 2025.1 ヘルプ

シグネチャーの変更

シグネチャーの変更リファクタリングは、関数シグネチャーに適用できるいくつかの異なる変更を組み合わせます。このリファクタリングを使用して、次のことができます。

  • 関数名を変更する

  • パラメーターの追加、削除、並べ替え

  • パラメーターにデフォルト値を割り当てます

関数のシグネチャーを変更すると、PyCharm は関数のすべての使用箇所を検索し、変更、反映、変更を安全に修正できる関数のすべての呼び出し、実装、置き換えを置き換えます。

パラメーターの追加

  1. 赤色でハイライトされている return 値をクリックします。

  2. Alt+Enter を押してパラメーター「<パラメーター名>」を作成しますを選択します。

  3. シグネチャーの変更ダイアログで、パラメーター設定を調整するか、提案された設定を受け入れます。

  4. リファクタリングをクリックします。

シグネチャーを適切に変更

エディターに入力するときに、関数のシグネチャーを変更することもできます。

  1. 関数のパラメーターの追加または編集を開始します。PyCharm はガターに the Refactoring icon を表示します。

    In-place change signature refactoring
  2. ガターのアイコンをクリックするか、Alt+Enter を押します。

    新しいパラメーターを追加する場合、PyCharm は、パラメーターのデフォルト値を追加し、使用箇所を更新するように要求します。

    Add default value for a parameter

    パラメーターを編集している場合、PyCharm は使用箇所の更新を提案します。

    Update usages for parameter
  3. 更新をクリックして提案を適用します。

関数のシグネチャーを変更する

  1. リファクタリングする関数の名前にキャレットを置きます。

  2. Ctrl+F6 を押します。または、メインメニューまたはコンテキストメニューからリファクタリング | シグネチャーの変更を選択します。

  3. シグネチャーの変更ダイアログで、必要に応じて関数シグネチャーに必要な変更を加えます。

    Change signature animation
    • 関数名を変更します。名前を変更するには、名前フィールドのテキストを編集します。

    • 関数パラメーターを管理します。パラメーターを設定するには、パラメーター領域のテーブルとボタンを使用します。

      • 新しいパラメーターを追加するには、The Add button をクリックし、対応するテーブル行で新しいパラメーターのプロパティを指定します。

      • パラメーターを削除するには、任意の行を選択して The Remove button をクリックします。

      • パラメーターの順序を変更するには、The Up icon および The down icon をクリックします。例: 特定のパラメーターをリストの最初に配置する場合は、そのパラメーターに対応する行のセルのいずれかをクリックし、必要な回数 The Up icon をクリックします。

      • 新しく追加されたパラメーターのデフォルト値を指定できます。既存の呼び出しで指定された値を明示的なプレースホルダーとして使用するために、シグネチャーにデフォルト値を使用するチェックボックスを選択しないでください。

  4. 予想される変更を確認し、リファクタリングの前に調整を行うには、プレビューをクリックします。

  5. リファクタリングをクリックします。

シグネチャーの変更ダイアログ

シグネチャーの変更リファクタリングは、関数シグネチャーに適用できるいくつかの異なる変更を組み合わせます。このリファクタリングを使用して、次のことができます。

  • 関数名を変更する

  • パラメーターの追加、削除、並べ替え

  • パラメーターにデフォルト値を割り当てます

関数のシグネチャーを変更すると、PyCharm は関数のすべての使用箇所を検索し、変更、反映、変更を安全に修正できる関数のすべての呼び出し、実装、置き換えを置き換えます。

項目

説明

名前

関数、メソッド、メソッド仕様の名前。

パラメーター

シグネチャー内のパラメーターのリスト。パラメーター項目では、パラメーターを使用して以下のアクションを実行することができます。

  • 追加 The Add icon : 新しいパラメーターを追加します。対応するテーブル行で新しいパラメーターのプロパティ(名前、型、デフォルト値)を指定できます。

  • 削除 The Remove icon : パラメーターを削除します。

  • 上へ The Up icon 下へ The Down icon : パラメーターを並べ替えます。

関連ページ:

検索ツールウィンドウ

検索ツールウィンドウには、次の検索結果が表示されます。パス内検索 / 置換、使用箇所の検索、構造検索と置換、リファクタリングプレビュー、データソース、テーブル、列の使用箇所の検索。検索ツールウィンドウには複数のタブを含めることができます。デフォルトでは、検索ごとに現在のタブで検索結果が更新されます。各検索の結果を別のタブに表示するには、ツールウィンドウのヘッダーを右クリックし、を選択します。デフォルトでは、検索ツールウィンドウが画面の下部に表示されます。これには、一連のボタン、結果のペイン、パス...

コード補完

基本コード補完は、可視性スコープ内のクラス、メソッド、キーワードの名前を補完するのに役立ちます。PyCharm はコンテキストを分析し、現在のキャレット位置から到達可能な選択肢を提案します。候補にはライブテンプレートも含まれます。補完機能は英語以外のキーボードレイアウトでも利用できます。基本補完を呼び出すデフォルトでは、PyCharm は入力時に自動的にコード補完ポップアップを表示します。あるいは、を押すか、メインメニューからを選択することもできます。以下のイメージは、次の場合の基本的なコード...

コードのリファクタリング

リファクタリングは、新しい機能を作成せずにソースコードを改善するプロセスです。リファクタリングは、コードを安定させ、保守を容易にできます。リファクタリングを実行するには、以下の一般的な手順に従いますリファクタリングするシンボルまたはコード断片を選択 (またはカーソルを合わせて) します。次の PyCharm コンポーネントのシンボルを選択できます。プロジェクトビュー、構造ツールウィンドウ、エディター、UML クラスダイアグラム、以下のいずれか 1 つを実行します: メインのメニュー上または選択した...

パッケージとモジュールに変換する

PyCharm を使うと、Python モジュールを Python パッケージに変換したり、その逆を行ってソースファイルを安全に再構成することができます。Python パッケージに変換する:パッケージは通常、モジュールと初期化コード(ファイル __init__.py)を含むディレクトリです。モジュールは、他のモジュールにインポートできる Python 定義を持つ .py ソースファイルです。Python モジュールを Python パッケージに変換するには .py ファイルを選択します。を選択します。プ...