コードを再フォーマットおよび再配置する
PyCharm を使うと、現在の コードスタイルスキーム または .editorconfig ファイルで指定した要件に従ってコードを再フォーマットできます。 .editorconfig で定義されていないものがあれば、プロジェクト設定から取得されます。
コードの一部、ファイル全体、ファイルのグループ、ディレクトリ、モジュールを再フォーマットできます。 また、コードの一部または一部のファイルを再フォーマットから除外することもできます。 PyCharm は、Python コードの配置とフォーマットに関する PEP 8のルールと要件に準拠しています。
コード箇所を整形する。
エディターで、再フォーマットしたいコードフラグメントを選択します。
再フォーマットする前に、選択したコードに適用されているコードスタイル設定を確認できます。 Alt+Enter を押して、 Adjust code style settings をクリックします。
メインメニューで、 に移動するか、 Ctrl+Alt+L を押します。
または、表示される ツールバーで、
コードの整形 をクリックします。
ファイルを再フォーマットする
ファイルをエディターで開いて Ctrl+Alt+Shift+L を押すか、 Project ツールウィンドウでファイルを右クリックして を選択します。
開いた ファイルの整形 ダイアログで、必要に応じて、次の整形オプションを選択します：
インポートの最適化: 未使用のインポートを削除する、足りないものを追加する、インポート文を整理するには、このオプションを選択します。
Rearrange entries: コードスタイル設定で指定された 配置規則に基づいてコードを再配置する必要がある場合は、このオプションを選択します。
Code cleanup: コードクリーンアップインスペクションを実行するには、このオプションを選択します。
Do not keep line breaks ：コードスタイルの設定に従って改行を整形します。 このオプションは、 設定を上書きします。
実行 をクリックしてください。
再フォーマット中にコードに加えられた正確な変更を確認するには、 ローカル履歴機能を使用します。
行のインデントを整形する。
指定した設定に基づいて行のインデントを再フォーマットできます。
エディター内で、必要なコードの一部を選択して Ctrl+Alt+I を押します。
インデント設定を調整する必要がある場合は、 設定 ダイアログ (Ctrl+Alt+S) で に進みます。 インデントを変更する言語を選択します。
タブとインデント タブで、適切なインデントオプションを指定し、 OK をクリックします。
保存時にコードを自動的に整形する。
IDE を構成し、 保存時に変更されたファイルのコードを自動的に再フォーマットできます。
Ctrl+Alt+S を押して設定を開き、 を選択します。
コードの整形 オプションを有効にします。
さらに、IDE がコードを整形する方法を構成できます：
Configure scope… をクリックして、 再フォーマットから除外したいファイル名やディレクトリのパターンを指定します。
All file types リストから、コードを再フォーマットするファイルのタイプを選択します。
プロジェクトがバージョン管理下にある場合は、 ファイル全体 または Changed lines を選択します。
Changed lines を選択した場合、再フォーマットはローカルで変更されたが、リポジトリにまだチェックインされていないコード行のみに適用されます。
コミット時にコードを整形する。
プロジェクトが バージョン管理されている場合は、リポジトリに変更をコミットするときにコードを自動的に再フォーマットできます。 この場合、追加または変更されたコードのみが再フォーマットされます。
Alt+0 を押して コミット ツールウィンドウを開き、 コミットオプションを表示
をクリックします。コミットチェック メニューで、 コードの整形 オプションを有効にします。
オプションを有効にすると、コミットするたびに追加または変更されたコードが再フォーマットされます。
整形からファイルを除外する。
ファイルやディレクトリのグループを再フォーマット、 コード配置 、および インポートの最適化から除外できます。
設定 ダイアログ (Ctrl+Alt+S) で、 に進みます。
フォーマッター タブに切り替え、 Do not format フィールドに、 グロブパターン(英語)を使用して除外するファイルとディレクトリを入力します。
セミコロン
;で区切って複数のグロブパターンを指定できます。
をクリックすると、フィールドが展開され、各パターンが別々の行に表示されます。変更を適用して、ダイアログを閉じます。
エディターでのコード箇所の整形からの除外。
設定 ダイアログ (Ctrl+Alt+S) で、 に進みます。
フォーマッター タブに切り替えて、 Turn formatter on/off with markers in code comments オプションを有効にします。
エディターで、除外する領域の先頭に、行コメント Ctrl+/ を作成し、
@formatter:offと入力します。 領域の最後に、別の行コメントを作成し、@formatter :onと入力します。マーカー間のコードは再フォーマットされません。
既存のフォーマットを保持
コードを再フォーマットするときに無視されるフォーマット規則を選択できます。 例：単純なメソッドや関数を 1 行に収めるように IDE を調整することができますが、通常はコードの整形後に複数行に展開されます。
メインメニューで に移動し、プログラミング言語を選択して、 折り返しと波括弧 タブを開きます。
整形時の保持 セクションで、無視したいフォーマット規則を選択し、適用するものを選択解除します。
コードを再フォーマットする (Ctrl+Alt+L)。
PyCharm は、現在のスタイル設定に従ってコードを再フォーマットし、選択したルールの既存のフォーマットを維持します。
コードの再配置
コードスタイルページで設定された配置ルールに従って、 設定 ダイアログでコードを再配置できます。
コードエントリの並べ替え
設定 ダイアログ（Ctrl+Alt+S ）で、 に移動します。
配置規則を作成する言語を選択します。
配置 タブで、グループ化ルールや一致ルールなどの適切なオプションを指定します。
変更を保存するには、 OK をクリックします。
エディターで、再配置するコードエントリを選択し、メインメニューの に移動します。