# 管理任务

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/idea/llms.txt).

当您处理一个项目时，可以将工作组织成需要完成的小任务。

这些任务可以由您自己设定。 在 IntelliJ IDEA 中，您可以将一大块工作分成较小的任务，并将它们与 changelists 关联起来。

这些也可以是来自您的问题跟踪器的任务。 例如，您可以直接从 IntelliJ IDEA 处理分配给您的任务和错误。 要做到这一点，请连接 IDE 和您的跟踪器帐户。

Procedure: 安装问题跟踪器插件

此功能依赖于 [问题跟踪器](https://plugins.jetbrains.com/plugin/11545-issue-trackers) 插件，需要安装并启用。

1. 按 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `插件` 。

2. 找到  问题跟踪器  插件，然后点击   安装  。 如果出现提示，请重启 IDE。

## 配置与问题跟踪器的集成

IntelliJ IDEA 支持与以下内容集成：

* [Jira](https://www.atlassian.com/software/jira)

* [YouTrack](https://www.jetbrains.com/zh-cn/youtrack/)

* [Lighthouse](https://lighthouseapp.com/)

* [PivotalTracker](https://www.pivotaltracker.com/)

* [Redmine](https://www.redmine.org/)

* [Trac](https://trac.edgewall.org/)

* [FogBugz](https://www.fogbugz.com/)

* [Mantis](https://www.mantisbt.org/)

* [Asana](https://asana.com/)

* [Assembla](https://www.assembla.com/features/bug-tracking)

* [Sprint.ly](https://sprint.ly/)

* [Trello](https://trello.com/)

* [GitLab](https://about.gitlab.com/)

* [Bugzilla](https://www.bugzilla.org/)

* [GitHub](https://github.com/)

* [通用服务器](tutorial-configuring-generic-task-server.html)

Procedure: 将 IDE 连接到您的追踪器

1. 在   设置  对话框 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))中，选择  `工具 | 任务 | 服务器` 。

2. 点击 !["添加"按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) 并从列表中选择必要的问题追踪器。

3. 输入连接详细信息。 请注意，设置因您的问题跟踪器而异。

通常，您需要指定服务器 URL 和连接凭据：   用户名   和   密码  。

在某些情况下，您需要输入一个 API token 而不是您的密码。

例如，如果您将 IDE 连接到 YouTrack，   密码   字段将替换为   令牌  。 了解详情，请参阅 [管理永久令牌](https://www.jetbrains.com/zh-cn/help/youtrack/standalone/Manage-Permanent-Token.html)。

对于 Jira，启用   使用个人访问令牌   选项，以使用 [令牌](https://confluence.atlassian.com/enterprise/using-personal-access-tokens-1026032365.html)，而不是用户名称和密码。

4. 请选择   共享 URL   选项，以允许团队的其他成员访问服务器。 启用此选项后，服务器 URL 及其类型将保存到  `.idea/misc.xml`  文件中，该文件可以通过版本控制在开发团队成员之间共享。

5. 如果要使用代理服务器访问服务器，请点击   代理设置…  。 您可以在 [HTTP Proxy](settings-http-proxy.html)部分找到有关代理设置的更多信息。

![服务器页面常规选项卡上的设置](https://resources.jetbrains.com/help/img/idea/2026.3/tasks-connect-server.png)

6. 在   提交消息  选项卡，您可以启用为变更列表添加提交消息，并配置消息模板。

7. 在   服务器配置  选项卡上，配置高级 [参数](#server-configuration-tab-controls)以连接到您的问题跟踪器。

此选项卡仅适用于某些跟踪器（例如， [默认不支持的跟踪器](tutorial-configuring-generic-task-server.html)）。

> **Tip:**
> 此选项卡中的字段提供代码补全功能。

### 服务器配置选项卡参数

|  条目  |  描述  |
| --- | --- |
|  登录 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 受限的 问题跟踪器s，这类 API 无法在单个响应中发送所有所需信息。     |
|  响应类型  |  请选择您的问题跟踪器响应的格式：   XML   表示 XPath、   JSON   表示 [JSONPath](https://goessner.net/articles/JsonPath/)，或   文本   表示正则表达式。  |
|  选择器表  |  选择器允许您指定要从服务器响应中检索的有关问题的信息。  |
|   `tasks`   |  服务器响应中问题列表的路径。 此字段为必填字段。  |
|   `id`   |  服务器响应中通向问题 ID 的路径。 此字段为必填字段。  |
|   `summary`   |  服务器响应中问题标题的路径。 此字段为必填字段。  |

> **Tip:**
> 有关配置这些参数的更多信息，请参阅 [教程：配置通用任务服务器](tutorial-configuring-generic-task-server.html)。

Procedure: 指定其他集成选项

1. 在   设置  对话框 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))中，选择  `工具 | 任务` 。

2. 配置必要的选项：

* 更改列表名称格式设置 ：当您打开或创建一个新任务时，IntelliJ IDEA [提示您创建一个与此任务相关的新变更列表](#changelist)。 在此字段中，您可以指定用于为新 changelists 生成名称的模板。 点击 ![添加占位符按钮 null},{](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)，从列表中选择占位符。

* 功能分支名称格式设置 ：当您创建或打开新任务时，IntelliJ IDEA 会提示您创建一个新的 feature 分支。 在此字段中，您可以配置用于生成新功能分支名称的模板。 点击 ![添加占位符按钮 null},{](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)，从列表中选择占位符。 使用 小写 和 将空格替换为 选项来配置提示的功能分支名称。 这些设置在您的 IDE 与问题跟踪器集成时很有用。 例如， `DSGN-0001 Add new icon` 任务名称将被转换为 `dsgn-0001add-new-icon` 功能分支名称。 > **Tip:** > 在创建之前，您始终可以修改功能分支名称，如果生成的名称不符合您的需求。

* 任务历史长度 ：IntelliJ IDEA 存储的任务数。

* 在提交时保存上下文 ：每次提交更改时，IntelliJ IDEA 会创建一个新的本地任务，保存您使用的文件、书签和断点。 这样，您将来可以随时快速恢复与该任务相关的所有标签页。

* 启用问题缓存 ：优化 IntelliJ IDEA 与 您的 问题跟踪器 之间的同步。 如果使用“慢速”问题跟踪系统，特别建议进行同步。 IntelliJ IDEA 缓存了从跟踪器加载的问题列表，并不断更新这些问题。 您可以指定应缓存多少问题，以及 IntelliJ IDEA 应多长时间更新一次这些问题的信息。 ![任务设置](https://resources.jetbrains.com/help/img/idea/2026.3/tasks_settings.png)

## 任务

在 IntelliJ IDEA 中，有两类任务：

* 从您的 问题跟踪器 加载到 IntelliJ IDEA 的任务。 这些是 tracker tasks 。 跟踪任务与您问题跟踪器中的相应问题相关联。 这使您能够直接从 IntelliJ IDEA 监控和更新它们。

* 最初在 IntelliJ IDEA 中创建的任务。 这些是 本地任务 。 本地任务与问题追踪器无关。

如果已创建任一类型的至少一个任务，工具栏上会显示一个用于在任务之间切换的下拉菜单。

Procedure: 打开 tracker 任务

将 IntelliJ IDEA 连接到问题跟踪器后，跟踪器任务就会加载到 IntelliJ IDEA 中。

1. 在主菜单中，转到  `工具 | 任务＆上下文 | 打开任务` 。

2. 从列表中选择所需的任务。

3. 在   打开任务   对话框中，可以更新问题状态。

> **Note:**
> 更新问题状态   选项适用于 YouTrack、JIRA、GitHub、Trello、Pivotal 和 Bugzilla。

如果要关闭当前在编辑器中打开的所有选项卡，请选中   清除当前上下文   复选框。

4. 在   版本控制系统操作  部分，您可以创建一个新的更改列表，选择一个您想要贡献的现有分支，或创建一个新的分支。

还可以 [搁置当前更改](shelving-and-unshelving-changes.html)，以便稍后再处理。

![打开跟踪器任务](https://resources.jetbrains.com/help/img/idea/2026.3/tasks_open_tracker_task.png)

Procedure: 创建本地任务

在 IntelliJ IDEA 中，您可以创建不源自您的问题追踪系统的本地任务。

1. 在主菜单中，前往  `工具 | 任务＆上下文 | 打开任务` 。

2. 在   输入任务名称  对话框中，选择   创建新任务  。

3. 请输入新任务的名称。

如果要关闭当前在编辑器中打开的所有选项卡，请选中   清除当前上下文   复选框。

4. 在   版本控制系统操作  部分，您可以 [创建一个新的变更列表](managing-changelists.html)，选择一个您想贡献的现有分支，或创建一个新分支。

还可以 [搁置当前更改](shelving-and-unshelving-changes.html)，以便稍后再处理。

Procedure: 查看任务描述

当您选择要切换的任务时，任务列表仅显示任务 ID。 此信息并不总是足够，因为它既不反映导致问题的步骤，也不反映相关讨论。

1. 在主菜单中，前往  `工具 | 任务＆上下文 | 打开任务` 。

2. 打开所需的任务并按 `Ctrl+Q` (Windows), `F1` (macOS), `⌃ J` (IntelliJ IDEA Classic (macOS)), `⌘ I` (macOS System Shortcuts), `Ctrl+Q` (XWin), `Ctrl+Q` (GNOME), `Ctrl+Q` (KDE), `Ctrl+Q` (Emacs), `Ctrl+Q` (Sublime Text), `Ctrl+Q` (Sublime Text (macOS)), `Ctrl+K, I` (Visual Studio), `⌘ K, I` (Visual Studio (macOS)), `Ctrl+Q` (NetBeans), `Alt+Middle-Click` (Eclipse), `⌥ Middle-Click` (Eclipse (macOS))，即可在 IntelliJ IDEA 中打开任务描述。

或者，前往  `工具 | 任务&上下文`  并点击   显示“任务 ID”描述   或   在浏览器中打开“任务 ID”  。

Procedure: 查看已关闭的任务

如果整个项目或受影响的目录处于版本控制之下，则已关闭的本地任务是未与更改列表关联的任务。

已关闭的跟踪任务是在您的问题跟踪器中具有已关闭状态的任务。

1. 在主菜单中，前往  `工具 | 任务＆上下文 | 打开任务` 。

2. 请选择   包含已关闭的任务   复选框。

Procedure: 关闭任务

* 在主菜单中，进入  `工具 | 任务&上下文` 并点击   关闭活动任务  。

这将关闭 IntelliJ IDEA 中的当前上下文。 选中必要的复选框以提交更改，并可选择合并已创建的分支。 对于跟踪器任务，您也可以更改其状态。 新的状态将会传播到您的问题跟踪器中。

Procedure: 删除任务

如果您不需要某个任务在 IntelliJ IDEA 中出现，您可以将其从任务列表中移除。

1. 在主菜单中，前往  `工具 | 任务 & 上下文 | 切换任务` 。

2. 请选择一个或多个您要删除的任务。

请使用 `Shift` (Windows), `Shift` (macOS), `Shift` (IntelliJ IDEA Classic (macOS)), `Shift` (macOS System Shortcuts), `Shift` (XWin), `Shift` (GNOME), `Shift` (KDE), `Shift` (Emacs), `Shift` (Sublime Text), `Shift` (Sublime Text (macOS)), `Shift` (Visual Studio), `Shift` (Visual Studio (macOS)), `Shift` (NetBeans), `Shift` (Eclipse), `Shift` (Eclipse (macOS)) 键（用于相邻项目）或 `Ctrl` (Windows), `Ctrl` (macOS), `Ctrl` (IntelliJ IDEA Classic (macOS)), `Ctrl` (macOS System Shortcuts), `Ctrl` (XWin), `Ctrl` (GNOME), `Ctrl` (KDE), `Ctrl` (Emacs), `Ctrl` (Sublime Text), `Ctrl` (Sublime Text (macOS)), `Ctrl` (Visual Studio), `Ctrl` (Visual Studio (macOS)), `Ctrl` (NetBeans), `Ctrl` (Eclipse), `Ctrl` (Eclipse (macOS)) 键（用于非相邻项目）进行多选。

3. 点击右箭头按钮并选择   移除  。

当您删除跟踪任务时，您将它们从 IDE 中移除。 它们将保留在您的问题跟踪器中。 在这种情况下，本地任务将被完全移除，因为它们未连接到问题跟踪器。

## 时间跟踪

使用 IntelliJ IDEA，您可以跟踪在编辑器中执行任务所花费的时间。 对于本地任务，若您想在进行项目时了解确切完成任务所需的时间，此信息可能会有所帮助。

对于跟踪任务，如果您的问题跟踪器配置要求您记录在任务上花费的时间，此选项很有用。 在这种情况下，您可以将您的时间日志从 IntelliJ IDEA 发送到追踪器。

Procedure: 安装时间跟踪插件

此功能性依赖 [时间跟踪](https://plugins.jetbrains.com/plugin/11546-time-tracking)插件，您需要安装并启用该插件。

1. 按 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `插件` 。

2. 找到  时间跟踪  插件，然后点击   安装  。 如果出现提示，请重启 IDE。

Procedure: 启用时间跟踪

1. 按 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `工具 | 任务 | 时间跟踪` 。

2. 请选择   启用时间跟踪   复选框。

3. （可选）更改   暂停延迟  值。

您可以在此处指定在任务被视为挂起之前，必须保持不活动的时间长度。

Procedure: 跟踪时间

* 点击 ![自动模式](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.run.resume.svg) 进行自动时间记录。

要进行手动时间跟踪，请点击 ![活动任务的开始时间](https://resources.jetbrains.com/help/img/idea/2026.3/tasks-core.icons.expui.startTimer.svg)。 要停止手动时间追踪，请点击 ![停止活动任务的时间](https://resources.jetbrains.com/help/img/idea/2026.3/tasks-core.icons.expui.stopTimer.svg)。

> **Tip:**
> 若要重新打开   时间跟踪  工具窗口，请选择  `视图 | 工具 Windows | 时间跟踪` 。

Procedure: 将时间日志发送到跟踪器

1. 请点击   将工作项发布到缺陷跟踪器   ![将项目导出到缺陷跟踪系统](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.export.svg) 在   时间跟踪   工具窗口。

2. 指定您要记录的时间间隔，并在必要时添加注释。 点击   OK  。

## See also

### 教程和示例

[教程：配置通用任务服务器](tutorial-configuring-generic-task-server.html)

