PyCharm 2024.1 ヘルプ

コードスタイル: Python

このページを使用して、Python ファイルのフォーマットオプションを設定します。これらの設定を変更すると、プレビューペインに、コードへの影響が表示されます。

タブとインデント

項目

説明

タブ文字を使用する

  • このチェックボックスをオンにすると、タブ文字が使用されます。

    • Tab キー押下時

    • インデント用

    • コードの再フォーマット

  • チェックボックスをオフにすると、PyCharm はタブの代わりにスペースを使用します。

スマートタブ

  • このチェックボックスをオンにすると、コードブロックのネストによって定義されるインデントの部分は、タブと(必要な場合は)スペースで構成され、アライメントによって定義されるインデントの部分はスペースのみで構成されます。

  • このチェックボックスをオフにすると、タブのみが使用されます。これは、指定されたタブサイズに適合するスペースのグループが自動的にタブに置き換えられることを意味します。これにより、細かい配置が解除される可能性があります。

タブ文字を使用するチェックボックスが選択されている場合は、スマートタブチェックボックスが使用可能です。

タブサイズ

このフィールドには、タブに含めるスペースの数を指定します。

インデント

このフィールドでは、各インデントレベルに挿入するスペースの数を指定します。

連続インデントの文字数

このフィールドでは、式、メソッド宣言、メソッド呼び出しで、配列の要素間に挿入するスペースの数を指定します。

空行でインデントを保持する

このチェックボックスを選択すると、PyCharm は、空の行にコードが含まれているかのようにインデントを保持します。

このチェックボックスをオフにすると、PyCharm はタブ文字とスペースを削除します。

スペース

このタブを使用して、コード内のスペースが必要な場所を指定します。PyCharm で特定の場所にスペースを自動的に挿入するには、リスト内のこの場所の横にあるチェックボックスを選択します。結果はプレビューペインに表示されます。

折り返しと波括弧

このタブで、PyCharm がソースコードの再フォーマットに適用するコードスタイルオプションをカスタマイズします。左側のペインには、例外のリスト(整形時の保持)と、さまざまなコード構造(リスト、ステートメント、操作、アノテーションなど)の配置および配置オプションが含まれています。右側のペインにはプレビューが表示されます。

アライメントはインデントオプションよりも優先されます。

ビジュアルガイド

複数の右マージンを指定するには、ビジュアルガイドフィールドを使用します。デフォルト値のままにするか、余白のスペース数を入力することができます。複数のマージンを指定する場合は、コンマで区切って番号を入力します。

整形時の保持

チェックボックスを使用して、ソースコードの再フォーマット時に PyCharm が行う例外を構成します。例: デフォルトでは、改行チェックボックスが選択されています。コードに標準の規則よりも短い行が含まれている場合は、ソースコードを再フォーマットする前に改行チェックボックスを無効にすることで変換できます。

右マージンを超えないようにする

このチェックボックスをオンにすると、フォーマッタはドキュメント行が右マージンを超えることを避けるために最善を尽くします。このオプションは、折り返さないラッピングスタイルよりも優先されます。

メソッド宣言パラメーター

設定の横にあるフィールドをクリックして、使用可能なオプションを確認します。

  • 折り返さない : このオプションを選択すると、特別な折り返しスタイルは適用されません。

    このオプションを選択すると、ネストされたアライメントと波括弧の設定は無視されます。

  • 長い場合は折り返す : このオプションを選択すると、右マージンを超える行が適切なインデントで折り返されます。

  • 常に折り返す : このオプションを選択すると、リスト内のすべての要素が折り返され、行ごとに適切なインデントを持つ要素が 1 つになります。

  • 長い場合は切り捨てる : このオプションを選択すると、リスト内の右マージンを超える要素が折り返され、行ごとに適切なインデントを持つ要素が 1 つになります。

項目

説明

複数行の場合は揃える

このチェックボックスをオンにすると、次の各行の同じ列でコード構成が開始されます。それ以外の場合は、コード構造の位置は現在のインデントレベルによって決定されます。

')' 後の新しい行

指定した文字の後のコードを改行するには、このチェックボックスを選択します。

ライン上に '(' を配置します

宣言行の後の行の先頭に左中括弧を配置するには、このオプションを選択します。

メソッド呼び出しの引数

設定の横にあるフィールドをクリックして、使用可能なオプションを確認します。

  • 折り返さない : このオプションを選択すると、特別な折り返しスタイルは適用されません。

    このオプションを選択すると、ネストされたアライメントと波括弧の設定は無視されます。

  • 長い場合は折り返す : このオプションを選択すると、右マージンを超える行が適切なインデントで折り返されます。

  • 常に折り返す : このオプションを選択すると、リスト内のすべての要素が折り返され、行ごとに適切なインデントを持つ要素が 1 つになります。

  • 長い場合は切り捨てる : このオプションを選択すると、リスト内の右マージンを超える要素が折り返され、行ごとに適切なインデントを持つ要素が 1 つになります。

項目

説明

複数行の場合は揃える

このチェックボックスをオンにすると、次の各行の同じ列でコード構成が開始されます。それ以外の場合は、コード構造の位置は現在のインデントレベルによって決定されます。

')' 後の新しい行

指定した文字の後のコードを改行するには、このチェックボックスを選択します。

ライン上に '(' を配置します

このオプションを選択すると、開始ブレースがコールラインの後のラインの先頭に配置されます。

コロンの後に改行を強制する

これらのオプションを使用すると、単一句ステートメントおよび複数句ステートメント(デフォルトで設定)のコロンの後に改行を追加できるようになります。

コレクションおよび包含

複数行の場合は揃えるチェックボックスを選択して、複数行でフォーマットされたコレクション内の要素の配置を有効にします。

インポートステートメントから

設定の横にあるフィールドをクリックして、使用可能なオプションを確認します。

  • 折り返さない : このオプションを選択すると、特別な折り返しスタイルは適用されません。

    このオプションを選択すると、ネストされたアライメントと波括弧の設定は無視されます。

  • 長い場合は折り返す : このオプションを選択すると、右マージンを超える行が適切なインデントで折り返されます。

  • 常に折り返す : このオプションを選択すると、リスト内のすべての要素が折り返され、行ごとに適切なインデントを持つ要素が 1 つになります。

  • 長い場合は切り捨てる : このオプションを選択すると、リスト内の右マージンを超える要素が折り返され、行ごとに適切なインデントを持つ要素が 1 つになります。

項目

説明

複数行の場合は揃える

このチェックボックスをオンにすると、次の各行の同じ列でコード構成が開始されます。それ以外の場合は、コード構造の位置は現在のインデントレベルによって決定されます。

')' 後の新しい行

指定した文字の後のコードを改行するには、このチェックボックスを選択します。

ライン上に '(' を配置します

このオプションを選択すると、インポートステートメントの行の後の行の先頭に左中括弧が配置されます。

複数行の場合は括弧を強制する

ステートメントが複数行を占める場合に中括弧を自動的に導入するには、このオプションを選択します。

複数行の場合はコンマを末尾に付ける

ステートメントが複数行を占める場合、コンマを自動的に追加するには、このオプションを選択します。

辞書リテラル

項目

説明

'}' 後の新しい行

指定した文字の後のコードを改行するには、このチェックボックスを選択します。

ライン上に '{' を配置します

このオプションを選択すると、インポートステートメントの行の後の行の先頭に左中括弧が配置されます。

ぶら下げ閉じ括弧

終了括弧をインデントするには、このチェックボックスを選択します。このオプションはデフォルトで無効になっています。

空白行

このタブを使用して、再フォーマット後に PyCharm が保持してコードに挿入する空白行の数と場所を定義します。ロケーションのタイプごとに、挿入する空白行の数を指定します。結果はプレビューペインに表示されます。

項目

説明

維持する最大空白行

この領域には、指定された場所で再フォーマットした後に保持する空白行の数を指定します。

最大空白行

この領域では、指定された位置に存在する空白行の数を指定します。

インポート

この表は、インポートが最適化されたときに実行されるアクションをリストしています。

項目

説明

import ステートメントをソートする

PEP 8 による個々のインポートグループ(英語)内のソートインポートを有効または無効にするには、このチェックボックスをオンまたはオフにします。

次のチェックボックスはソート順に影響します。

"from" インポートでインポートした名前をソートする

このチェックボックスを選択すると、from ... import ... ステートメントのインポートがアルファベット順にソートされます。

未選択

選択済み

from sys import version, path, modules
from sys import modules, path, version

グループ内で明示的にインポートと「インポート」を別々にソートする

このチェックボックスが選択されていない場合、同じモジュールからのインポートは、そのタイプにかかわらずグループ化されますが、import ステートメントが最初に実行され、from ... import ... ステートメントが次に行われます。

このチェックボックスが選択されている場合、インポートは最初にそのタイプ(最初の import、次の from ... import ...)でソートされ、次にアルファベット順にソートされます。

未選択

選択済み

import os from os import getenv import sys from sys import path
import os import sys from os import getenv from sys import path

大文字と小文字を区別しないで並べ替え

このチェックボックスでは、インポート文の大文字小文字を区別しないソートが有効になります。デフォルトでは、インポート文は大文字と小文字が区別されてソートされます。

未選択

選択済み

from django.http import HttpResponseRedirect from django.http import cookie from django.shortcuts import render from django.urls import reverse
from django.http import cookie from django.http import HttpResponseRedirect from django.shortcuts import render from django.urls import reverse

"from" インポートの構造

そのまま残す

このチェックボックスをオンにすると、インポート元の再構築は行われません。

同じソースでインポートを結合する

このチェックボックスを選択すると、同じソースの「元」インポートが結合されます。

未選択

選択済み

from django.http import HttpResponseRedirect from django.shortcuts import get_object_or_404, render from django.http import HttpResponse
from django.http import HttpResponseRedirect, HttpResponse from django.shortcuts import get_object_or_404, render

常に分割インポート

このチェックボックスを選択すると、インポート元は常に個別に配置されます。

未選択

選択済み

from django.http import HttpResponseRedirect from django.shortcuts import get_object_or_404, render from django.http import HttpResponse
from django.http import HttpResponse from django.http import HttpResponseRedirect from django.shortcuts import get_object_or_404 from django.shortcuts import render

その他

項目

説明

辞書の配置

ドロップダウンリストから、dict アラインメントのタイプを選択します。

  • 揃えない : 連続した行の dict の要素は整列しません。

  • コロンでそろえる : 連続した行の dict の要素はコロンに対して整列されます。

  • 値でそろえる : 連続した行の dict の要素は値に対して整列されます。

ファイルの最後に改行を追加する

ファイルの末尾に改行文字を追加するには、このチェックボックスを選択します。

継続インデントを使用する

引数のリストに継続インデントを使用するにはメソッド呼び出しの引数チェックボックスを選択し、複数行のコレクションリテラルと内包表記にはコレクションおよび包含チェックボックスを選択します。デフォルトでは、メソッド宣言パラメーターが選択されているため、メソッド内のパラメーターは継続インデント値を使用してインデントされます。継続インデントの値は、タブとインデントタブで定義されます。これらのチェックボックスが選択されていない場合は、インデント値が使用されます。

選択して設定 ...

このリンクをクリックすると、現在の言語コードスタイルのベースとして使用される言語のリストが表示されます。現在の言語に適用可能な設定のみが採用されます。他のすべての設定は影響を受けません。

このリンクは、該当する場合、言語固有のコードスタイルページの右上隅に表示されます。

リセットをクリックして変更を破棄し、コードスタイル設定の最初のセットに戻ります。

関連ページ:

コードの再フォーマットと再配置

PyCharm を使用すると、現在のコードスタイルスキームまたは .editorconfig ファイルで指定した要件に従ってコードを再フォーマットできます。で定義されていないものがあれば、プロジェクト設定から取得されます。コードの一部、ファイル全体、ファイルのグループ、ディレクトリ、モジュールを再フォーマットできます。コードの一部または一部のファイルを再フォーマットから除外することもできます。PyCharm は、Python コードの配置とフォーマットに関する PEP8 の規則と要件に準拠しています。コ...

コード生成

インデックス、主キーおよび外部キーのコード生成の動作を設定します。このタブには、主キー制約と外部キー制約の名前、およびインデックスのテンプレートが含まれています。これらのテンプレートは、テーブルの作成またはテーブルの変更ダイアログで制約やインデックスを作成するときに、その制約とインデックスのデフォルト名を生成するために使用されます。テンプレートには変数とテキストを含めることができます。名前を生成すると、指定したテキストが文字通りに再現されます。例: テーブルにテンプレートを適用すると、生成された主...