PyCharm 2025.1 ヘルプ

タスクを管理する

プロジェクトで作業する場合は、完了する必要のある小さな作業で作業を整理できます。

これらは、自分で設定したタスクです。PyCharm では、大きな作業を小さなタスクに分割し、変更リストに関連付けることができます。

これらは、課題追跡システムからのタスクである可能性もあります。例: PyCharm から直接割り当てられたタスクやバグを処理できます。これを可能にするには、IDE とトラッカーアカウントを接続します。

課題追跡との統合を構成する

PyCharm は次のものとの統合をサポートします。

IDE をトラッカーに接続する

  1. 設定ダイアログ Ctrl+Alt+S で、ツール | タスク | サーバーを選択します。

  2. the Add button をクリックして、リストから必要な課題追跡を選択します。

  3. 接続の詳細を入力します。問題のトラッカーによって設定が異なることに注意してください。

    通常、サーバー URL および接続資格情報を指定する必要があります: ユーザー名およびパスワード

    場合によっては、パスワードの代わりに API トークンを入力する必要があります。

    例: IDE を YouTrack に接続する場合、パスワードフィールドはトークンに置き換えられます。詳細については、永久トークンの管理を参照してください。

    Jira の場合、ユーザー名とパスワードの代わりにトークン(英語)を使用するには、個人用アクセストークンの使用オプションを有効にします。

  4. URL の共有オプションを選択して、チームの他のメンバーがサーバーにアクセスできるようにします。このオプションを有効にすると、サーバーの URL とそのタイプが .idea/misc.xml ファイルに保存され、バージョン管理を通じて開発チームのメンバー間で共有できます。

  5. プロキシサーバーを使用してサーバーにアクセスする場合は、プロキシ設定をクリックします。プロキシ設定の詳細については、HTTP プロキシセクションを参照してください。

    Setting on the General tab of the Servers page
  6. コミットメッセージ: タブで、変更リストのコミットメッセージの追加を有効にし、メッセージテンプレートを構成できます。

  7. サーバー構成タブで、課題追跡に接続するための詳細パラメーターを構成します。

    このタブは、一部のトラッカーでのみ使用できます(たとえば、そのままではサポートされていないトラッカーなど)。

サーバー構成タブのパラメーター

項目

説明

ログイン URL

認証用のリソース。IDE は、サーバーから問題のリストを取得する前に、毎回このリソースに要求を送信します(例: {serverUrl}/rest/user/login?login={username}&password={password})。

一般タブで HTTP 認証を使用するチェックボックスを選択した場合、フィールドは無効になります。

タスクリスト URL

サーバーから問題のリストを取得するためのリソース(例: {serverUrl}/rest/api/2/search)。

シングルタスク URL

問題に関する詳細情報を ID で取得するためのリソース(例: {serverUrl}/rest/api/2/issue/{id})。

別リクエストの各タスクチェックボックスを選択しない限り、このフィールドはオプションです。

GET または POST

必要なタイプの HTTP リクエストを選択します。

別リクエストの各タスク

このオプションを有効にすると、IDE は複数のリクエストを送信して、まず ID を持つ問題のリストを取得し、次にシングルタスク URL フィールドで指定されたリソースを使用して各問題の詳細情報を個別に取得できるようになります。

このオプションは、単一の応答ですべての必要な情報を送信できない、制限された REST API を備えた課題トラッカー用です。

レスポンスタイプ

課題トラッカーが応答する形式を選択します: XPath の場合は XMLJSONPath(英語) の場合は JSON、正規表現の場合はテキスト

セレクターの表

セレクターを使用すると、サーバーの応答から取得する問題に関する情報を指定できます。

tasks

サーバー応答の問題のリストへのパス。このフィールドは必須です。

id

サーバー応答内の問題 ID へのパス。このフィールドは必須です。

summary

サーバー応答の問題タイトルへのパス。このフィールドは必須です。

追加の統合オプションを指定する

  1. 設定ダイアログ Ctrl+Alt+S で、ツール | タスクを選択します。

  2. 必要なオプションを設定します。

    • 変更リスト名のフォーマット : 新しいタスクを開くか作成すると、PyCharm はこのタスクに関連付けられた新しい変更リストを作成するように求めます。このフィールドでは、新しい変更リストの名前を生成するために使用されるテンプレートを指定できます。

      the Add placeholder button をクリックして、リストからプレースホルダーを選択します。

    • feature ブランチ名フォーマット : 新しいタスクを作成または開くと、PyCharm は新しい機能ブランチを作成するように求めます。このフィールドでは、新機能ブランチの名前を生成するためのテンプレートを構成できます。

      the Add placeholder button をクリックして、リストからプレースホルダーを選択します。

      Lowercased および次の記号でスペースを置換オプションを使用して、プロンプト機能ブランチ名を構成します。

      IDE が課題追跡と統合されている場合、これらの設定は便利です。例: DSGN-0001 Add new icon タスク名は、dsgn-0001add-new-icon 機能ブランチ名に変換されます。

    • タスクヒストリー長 : PyCharm が保存するタスクの数。

    • コミット時にコンテキストを保存する : 変更をコミットするたびに、PyCharm は、作業したファイル、ブックマーク、ブレークポイントを保持する新しい閉じたローカルタスクを作成します。これにより、将来いつでもタスクに関連付けられているすべてのタブをすばやく復元できます。

    • 問題キャッシュを使用可能にする : PyCharm とあなたの issue tracker の間の同期を最適化します。「遅い」課題追跡システムを使用している場合は同期が特に推奨されます。

      PyCharm は、トラッカーからロードされた問題のリストをキャッシュし、繰り返し更新します。キャッシュされる問題の数と、PyCharm がそれらに関する情報を更新する頻度を指定できます。

      Task settings

タスク

PyCharm には、次の 2 種類のタスクがあります。

  • 課題トラッカーから PyCharm にロードされたタスク。これらはトラッカータスクです。トラッカータスクは、課題トラッカーの対応する課題にリンクされています。これにより、PyCharm から直接監視および更新できます。

  • もともと PyCharm で作成されたタスク。これらはローカルタスクです。ローカルタスクは、課題追跡システムとは関係ありません。

どちらかのタイプのタスクを少なくとも 1 つ作成した場合、タスクを切り替えるためのドロップダウンリストがツールバーに表示されます。

トラッカータスクを開く

トラッカータスクは、問題トラッカーに接続すると PyCharm にロードされます。

  1. メインメニューで、ツール | タスクおよびコンテキスト | タスクを開く Alt+Shift+N に移動するか、ツールバーのタスクコンボをクリックします。

  2. リストから必要なタスクを選択します。

  3. タスクを開くダイアログでは、問題の状態を更新できます。

    エディターで現在開いているすべてのタブを閉じるには、現在のコンテキストをクリアチェックボックスをオンにします。

  4. VCS 操作セクションでは、新しい変更リストを作成したり、既存のブランチを選択したり、新しいブランチを作成したりすることができます。

    現在の変更を保留して、後でそれらに戻すこともできます。

    Opening a tracker task

ローカルタスクを作成する

PyCharm では、課題トラッカーから発信されていないローカルタスクを作成できます。

  1. メインメニューで、ツール | タスクおよびコンテキスト | タスクを開くに移動します。タスクコンボを使用するか、Alt+Shift+N を押すこともできます。

  2. タスク名の入力ダイアログで、新しいタスクを作成するを選択します。

  3. 新しいタスクの名前を入力します。

    エディターで現在開いているすべてのタブを閉じるには、現在のコンテキストをクリアチェックボックスをオンにします。

  4. VCS 操作セクションでは、新しい変更リストを作成したり、コントリビュートする既存のブランチを選択したり、新しいブランチを作成したりできます。

    現在の変更を保留して、後でそれらに戻すこともできます。

タスクの説明を表示

切り替え先のタスクを選択する場合、タスクリストにはタスク ID のみが表示されます。この情報は、問題につながる手順も関連するディスカッションも反映していないため、必ずしも十分ではありません。

  1. メインメニューで、ツール | タスクおよびコンテキスト | タスクを開くに移動します。

  2. 必要なタスクを開き、Ctrl+Q を押して PyCharm または Alt+Shift+B のタスクの説明を開き、ブラウザーで説明を表示します。

または、ツール | タスクおよびコンテキストに移動し、' タスク ID' の説明を表示またはブラウザーで「タスク ID」を開きますをクリックします。

閉じたタスクを表示する

閉じられたローカルタスクは、プロジェクト全体または影響を受けるディレクトリがバージョン管理下にある場合、変更リストに関連付けられていないタスクです。

クローズドトラッカータスクは、課題トラッカーでクローズステータスを持つタスクです。

  1. タスクコンボをクリックし、タスクを開くをクリックします。

  2. 終了したタスクを含めるチェックボックスを選択するか、Alt+Shift+N を押します。

タスクを閉じる

  • メインメニューで、ツール | タスクおよびコンテキストに移動し、アクティブなタスクを閉じるをクリックします。

これにより、PyCharm の現在のコンテキストが閉じます。変更をコミットするために必要なチェックボックスを選択し、オプションで、作成されたブランチをマージします。トラッカータスクでは、状態を変更することもできます。新しい状態があなたの課題トラッカーに伝播されます。

タスクの削除

PyCharm に表示するタスクが必要ない場合は、タスクのリストから削除することができます。

  1. メインツールバーのタスクコンボをクリックします。

  2. 削除する 1 つ以上のタスクを選択します。

    複数選択の場合は、Shift (隣接アイテムの場合)または Ctrl (非隣接アイテムの場合)キーを使用します。

  3. 右矢印ボタンをクリックして、除去を選択します。

トラッカータスクを削除する場合、そのタスクは IDE から削除されます。タスクは問題トラッカーに残ります。この場合、ローカルタスクは問題トラッカーに接続されていないため、完全に削除されます。

タイムトラッキング

PyCharm を使用すると、エディターで作業するタスクに費やす時間を追跡できます。ローカルタスクの場合、この情報は、プロジェクトの作業中にタスクに競合する時間を正確に知りたい場合に役立ちます。

トラッカータスクの場合、このオプションは、課題トラッカー構成でタスクに費やす時間を記録する必要がある場合に便利です。この場合、PyCharm からトラッカーに時間ログを送信することができます。

タイムトラッキングを有効にする

  1. Ctrl+Alt+S を押して設定を開き、ツール | タスク | タイムトラッキングを選択します。

  2. タイムトラッキングを有効にするチェックボックスを選択します。

  3. (オプション)サスペンド遅延値を変更します。

    ここでは、タスクが中断されたと見なされるまで非アクティブでいなければならない時間を指定できます。

時間を追跡する

  • 自動時間ロギングのために Auto Mode をクリックします。

    手動で時間を追跡するには、Start time for the active task をクリックします。手動のタイムトラッキングを停止するには、Stop time for the active task をクリックします。

トラッカーに時間ログを送信する

  1. タイムトラッキングツールウィンドウで Bugtracker に作業項目を投稿します Export an item to the bug tracker をクリックします。

  2. ログに記録する時間間隔を指定し、必要に応じてコメントを追加します。OK をクリックします。

関連ページ:

チュートリアル: 汎用タスクサーバーを構成する

PyCharm は、すぐに使用できる多くのタスクトラッカーとの統合をサポートしています。ただし、PyCharm がまだサポートしていないトラッカーを使用する場合でも、いわゆる汎用サーバーを構成して統合できます。このチュートリアルでは、次の方法について説明します。汎用サーバーとして JIRA Cloud に接続します。自分に割り当てられた問題のリストを取得します。各問題について、ID、タイトル、説明、問題が作成および更新された日時を取得します。トラッカーへの接続を設定する前に、PyCharm に注...

HTTP プロキシ

デフォルトでは、PyCharm はシステムのプロキシ設定を使用します。このページを使用して、PyCharm の HTTP または SOCKS プロキシサーバーの設定をカスタマイズします。これらの設定は、プラグインのダウンロード、ライセンスの有効性の確認、インスタンス間での IDE 設定の同期、および IDE 自体のその他のタスクを実行するために PyCharm が確立する接続に影響します。プロキシなしプロキシなしで直接接続します。プロキシ設定を自動検出システムプロキシ設定 (デフォルトの動作) ま...

シェルブまたはスタッシュの変更

場合によっては、未完了のままのタスクを切り替えて、元に戻る必要があることがあります。作業内容を失うことなく複数の異なる機能に取り組むには、保留中の変更をシェルブまたはスタッシュすることができます。シェルブ vs スタッシュ:スタッシュの変更はシェルブと非常に似ています。スタッシュは Git によって生成され、PyCharm 内または PyCharm 外から適用できます。保留された変更を含むパッチは PyCharm によって生成され、IDE を通じて適用されます。また、スタッシュにはコミットされ...

プラグインのインストール

プラグインは PyCharm のコア機能を拡張します。例: プラグインをインストールして、次の機能を取得します。バージョン管理システム、課題追跡システム、ビルド管理サーバー、その他のツールとの統合。さまざまな言語とフレームワークのコーディング支援サポート。ショートカットのヒント、ライブプレビュー、ファイルウォッチャーなど。新しいプログラミング言語を学ぶのに役立つコーディング演習。プラグイン設定を開くを押して設定を開き、を選択します。マーケットプレースタブを使用して、JetBrains マーケット...

バックグラウンドタスク

検索と置換や VCS の更新などの長時間かかるタスクが実行されている場合、PyCharm はそれらの実行を自動的にバックグラウンドに移動します。特定のバックグラウンドタスクの進行状況は引き続き表示できます。バックグラウンドで実行中のタスクを表示するには、次のいずれかを実行するステータスバーをクリックして、バックグラウンドタスクダイアログを開きます。メインメニューで、に移動します。その結果、バックグラウンドタスクダイアログが開き、現在バックグラウンドで実行されているすべてのタスクが表示されます。タ...