PyCharm 2026.1 Help

カスタムテンプレートタグを作成して使用する

Django プラグインを有効化

この機能は、Django プラグインに依存しており、PyCharm にはデフォルトでバンドルされて有効になっています。 関連機能が利用できない場合は、プラグインが無効になっていないことを確認してください。

  1. Ctrl+Alt+S を押して設定を開き、 プラグイン​ を選択します。

  2. インストール済み タブを開き、 Django プラグインを見つけて、プラグイン名の横にあるチェックボックスを選択します。

Django を使用すると、新しいタグを設定して、組み込みのテンプレートタグではカバーされない機能を導入できます。 PyCharm は、対応するコードとナビゲーション支援を提供します。

カスタムテンプレートタグを作成する

  1. アプリケーションディレクトリに、 templatetags パッケージを作成します __init__.py ファイルが含まれている必要があります)。 例: Django/DjangoApp/templatetags

  2. templatetags パッケージで、 .py ファイル( my_custom_tags など)を作成し、そこにコードを追加してカスタムタグを宣言します。

    カスタムテンプレートタグ(英語)のコーディング方法の詳細については、Django ドキュメントを参照してください。

    カスタムテンプレートタグの追加

テンプレートにカスタムテンプレートタグを追加する

  1. エディターでテンプレートファイルを開き、それに対応するテンプレートタグを追加します。

    未解決の参照

    テンプレートファイルにカスタムタグをロードしていないため、PyCharm は Unresolved tag インスペクションエラーを表示します。

  2. クイックフィックスを使用して、欠落している参照を解決します。 キャレットをカスタムタグ名に置き、 Alt+Enter を押して、ロードするファイルを選択します。

    インスペクションでカスタムテンプレートを読み込む

    PyCharm は、 {% load %} タグをテンプレートファイルに追加して、参照を修正します。

    タグ実装名補完

PyCharm は、 settings.py ファイルの TEMPLATES セクションに builtins タグとして記録されたカスタムテンプレートタグも認識します。

タグの実装に移動する

設定ファイルにカスタムタグを記録したら、その宣言を含むファイルに移動できます。 キャレットをテンプレートタグのファイル名に置き、 Ctrl+B を押します。

2026 年 6 月 1 日