PyCharm 2026.1 Help

コピーライト​

プロジェクトには、コピーライトで保護したいファイルが含まれている場合があります。 各ファイルに個別にコピーライト表示を追加する代わりに、著作 権プロファイルを使用できます。

プロファイルは、コピーライト表示テキストと、このテキストが組み込まれる一連のファイル（スコープ ）を定義します。

同じプロジェクト内のファイルには、いくつかの異なるコピーライト表示が必要な場合があります。 この場合、複数のプロファイルを設定し、異なるスコープに関連付けることができます。

PyCharm では、コピーライトプロファイルは ローカルと 共有にできます。

共有プロファイルは .idea/copyright が .xml ファイル内に保存され、VCS を通じてチームの他のメンバーが利用できます。

ローカルコピーライトプロファイルは IDE レベルで保存され、現在の IDE インスタンスで開いたすべてのプロジェクトで使用できます。

プロファイルを使用すると、後でプロジェクト全体または特定のファイルのみにコピーライトテキストを挿入できます。

  1. Ctrl+Alt+S を押して設定を開き、 エディター | コピーライト | コピーライトプロファイル を選択します。

    新しく作成されたすべてのプロジェクトのデフォルトプロファイルを構成するには、 File | New Projects Setup | 設定 for New Projects を選択し、 エディター | コピーライト | コピーライトプロファイル に移動します。

  2. 追加 をクリックし、新しいプロファイルに名前を付けます。

  3. VCS で共有する​Rr3EwzqJ​イシイロソイララ を選択してこのプロファイルを .idea フォルダーに配置し、チームと共有するか、チェックボックスをオフにしてこのプロファイルをローカルに保持し、すべてのプロジェクトで使用できるようにします。

  4. コピーライト表示のテキストを入力します。

    プレーンテキストを入力するか、Velocity テンプレートを構成することができます。 テンプレートの場合は、 変数を使用し、 検証 をクリックして、正しく構成されていることを確認します。

    コピーライトプロファイルの設定

プロファイルが設定されると、テキストを追加する ファイルの範囲を選択したり、どの範囲にも含まれていないプロジェクト内のすべてのファイルの デフォルトプロファイルとしてこのプロファイルを設定したりできます。

コピーライト変数

現在、Velocity コンテキストで使用できる変数は次のとおりです：

名前

タイプ

コメント

$today

DateInfo

現在の日付と時刻。

$file.fileName

String

生成される現在開いているファイルの名前。

$file.pathName

String

生成される現在開いているファイルの完全なパスと名前。

$file.qualifiedClassName

String

生成される現在開いているファイルの完全修飾名。

$file.lastModified

DateInfo

現在のファイルが最後に変更された日時。

$project.name

String

現在のプロジェクトの名前。

$username

String

現在のユーザーの名前。

DateInfo には、次のプロパティがあります。

year

int

今年。

month

int

今月（1-12）。

day

int

現在の月の日付（1-31）。

hour

int

現在の時間（0-11）。

hour24

int

現在の時間（0-23）。

minute

int

時間の現在の分（0-59）。

second

int

分の現在の秒（0-59）。

DateInfo には次の方法があります。

format(String format)

String

日付と時刻のパターン文字列で指定された日付と時刻の形式。

デフォルトでは、コピーライトテンプレートには 2 つの年が含まれています。元の年と現在の年です。

新しいコピーライト表示を挿入すると、元の年は現在の年と一致するため、1 年だけが追加されます (たとえば、 2021)。 翌年、コピーライトを更新するときに通知を再生成できるようになり、元の年が現在の年 (2021 – 2022) と並んで表示されます。 こうすることで、コピーライトを更新するたびに年を手動で追加する必要がなくなります。

テンプレートでは、元の年は $originalComment.match("Copyright \(c\) (\d+)", 1, "-") コードで取得され、現在の年は $today.year コードで挿入されます。 詳しくは GitHub のソースコード(英語)を参照してください。

設定のコピーライトテンプレート

新しいコピーライトの形式がテンプレート内の以前のコピーライトの形式と一致する場合、年は正しく更新されることに注意してください。 ファイルから年を取得するテンプレートの部分を、元のコピーライトの形式と一致するように編集してください。

例: 元の通知が Copyright 2019-2021 MongoDB, Inc. であった場合は、テンプレートからコピーライト記号 (c) を削除します: $originalComment.match("Copyright (\d+)", 1, "-")

ファイルのスコープにプロファイルを割り当てる

構成されたコピーライトテキストを追加するファイルの スコープを選択します。

  1. Ctrl+Alt+S を押して設定を開き、 エディター | コピーライト を選択します。

  2. 追加 をクリックして（または Alt+Insert を押して）、リストから 既存の共有スコープを選択します。

    必要に応じて新しいスコープを定義することができます。 ページの下部にある スコープを追加または既存のスコープを変更するには、スコープを選択する リンクをクリックします。

  3. コピーライト​ リストから、スコープにリンクするプロファイルを選択します。

  4. 変更を適用して、ダイアログを閉じます。

    スコープとプロファイルの関連付け

その後、必要なファイルに コピーライトを追加できます。

デフォルトのコピーライトプロファイルを設定する

既定のプロファイルの設定は、プロファイルでカバーされるスコープに明示的に含まれていないファイルに適用されます。

  1. Ctrl+Alt+S を押して設定を開き、 エディター | コピーライト を選択します。

  2. デフォルトのプロジェクトコピーライト​ リストから、デフォルトプロファイルとして使用するプロファイルを選択します。

  3. 変更を適用して、ダイアログを閉じます。

    その後、必要なファイルに コピーライトを追加できます。

デフォルトでは、IDE は各行に接頭辞を付けて他のコメントの前にブロックコメントを貼り付け、ブロックの後に空白行を追加します。

すべてのファイルまたはファイルタイプごとに個別にデフォルトの形式を変更できます：

  1. Ctrl+Alt+S を押して設定を開き、 エディター | コピーライト | フォーマット を選択します。

  2. このページでは、すべてのタイプのファイルのフォーマットを構成できます。

    特定のファイルタイプのフォーマットを変更するには、 フォーマット ノードでそのフォーマットを選択します。

  3. フォーマットオプションを設定します。 プレビューセクションを使用して、新しいフォーマットが意図したとおりに表示されていることを確認します。

    デフォルトフォーマットのコピーライト表示

別のプロジェクトでプロファイルを使用する場合は、プロファイル設定を含む .xml ファイルを別の場所にコピーしてインポートします。

  1. Ctrl+Alt+S を押して設定を開き、 エディター | コピーライト | コピーライトプロファイル を選択します。

  2. プロファイルをインポート をクリックし、開いたダイアログで、使用するプロファイルを含む .xml ファイルを選択します。

  3. 必要に応じてプロファイルの名前を変更し、 OK をクリックします。

    設定が正常にインポートされると、確認のポップアップが表示されます。

    コピーライトプロファイルがインポートされたことを確認するポップアップ

  • 単一のファイルにテキストを挿入するには、エディターでファイルを開き、 Alt+Insert を押して、ポップアップから コピーライト​ を選択します。

  • ファイルのグループにテキストを挿入するには、 Project ツールウィンドウでノードを右クリックし、 コピーライトの更新 を選択します。 通知を更新するスコープを選択するように求められます。

    ノードには、異なるスコープに属するファイルが含まれている場合があります。 この場合、割り当てられたプロファイルに従ってコピーライト表示が生成されます。

    どのスコープにも属していないファイルがノードに含まれている場合、IDE はそのノードに デフォルトプロファイルを割り当てます。

  1. Ctrl+Alt+S を押して設定を開き、 エディター | コピーライト | コピーライトプロファイル を選択します。

  2. 必要なプロファイルを選択し、コピーライトテキストを編集します。

  3. コメントのコピーライトを検出する正規表現 フィールドに、ファイル内の既存のコピーライト情報を検索するために使用される正規表現を指定します。

    IDE はこの表現を使用して、他のコメントの中からコピーライトに関するコメントを識別します。 例: そのようなコメントは通常 Copyright という単語を含みます。

  4. 古いコピーライトと一致する場合はコピーライトの置き換えを許可する フィールドに、IDE がコピーライトテキストを更新するファイルを検索するために使用する正規表現を指定します。

    例: コピーライトに 2000-2006 および 2010-2016 年を含むすべてのファイルのコピーライトテキストを更新する場合は、 20[0-1][0-6] を指定します。

  5. 変更を適用して、ダイアログを閉じます。

  6. Project （Alt+1 ）ツールウィンドウで、テキストを更新するノードを右クリックし、 コピーライトの更新 を選択します。

IDE が変更を保存するたびにコピーライト表示を更新するように IDE を構成できます。

  1. Ctrl+Alt+S を押して設定を開き、 ツール | 保存時のアクション を選択します。

  2. コピーライト表示の更新 チェックボックスを選択します。

    このチェックボックスは、少なくとも 1 つの コピーライトプロファイルを構成し、このプロファイルが適用される ファイルのスコープを指定した場合に使用できます。

    プロファイルをまだ構成していない場合は、 Configure… リンクをクリックします。

    プロファイルが構成されたら、 ツール | 保存時のアクション に戻り、 コピーライト表示の更新 チェックボックスを有効にします。

  3. 変更を適用して、ダイアログを閉じます。

保存時に有効にできるアクションの詳細については、「変更を保存するときにアクションをトリガーする 」を参照してください。

2026 年 6 月 1 日
スクラッチファイルマクロ​