llms.txt: machine-readable documentation index. Markdown version of this page is also available.

IntelliJ IDEA 2026.3 Help

管理任务

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

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

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

安装问题跟踪器插件

此功能依赖于 问题跟踪器 插件,需要安装并启用。

  1. 按 Ctrl+Alt+S 打开设置,然后选择 插件。

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

配置与问题跟踪器的集成

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

将 IDE 连接到您的追踪器

  1. 在 设置 对话框 Ctrl+Alt+S 中,选择 工具 | 任务 | 服务器。

  2. 点击 "添加"按钮 并从列表中选择必要的问题追踪器。

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

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

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

    例如,如果您将 IDE 连接到 YouTrack, 密码 字段将替换为 令牌。 了解详情,请参阅 管理永久令牌。

    对于 Jira,启用 使用个人访问令牌 选项,以使用 令牌 ,而不是用户名称和密码。

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

  5. 如果要使用代理服务器访问服务器,请点击 代理设置…。 您可以在 HTTP Proxy部分找到有关代理设置的更多信息。

    服务器页面常规选项卡上的设置
  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 受限的 问题跟踪器s,这类 API 无法在单个响应中发送所有所需信息。

响应类型

请选择您的问题跟踪器响应的格式: XML 表示 XPath、 JSON 表示 JSONPath ,或 文本 表示正则表达式。

选择器表

选择器允许您指定要从服务器响应中检索的有关问题的信息。

tasks

服务器响应中问题列表的路径。 此字段为必填字段。

id

服务器响应中通向问题 ID 的路径。 此字段为必填字段。

summary

服务器响应中问题标题的路径。 此字段为必填字段。

指定其他集成选项

  1. 在 设置 对话框 Ctrl+Alt+S 中,选择 工具 | 任务。

  2. 配置必要的选项:

    • 更改列表名称格式设置 :当您打开或创建一个新任务时,IntelliJ IDEA 提示您创建一个与此任务相关的新变更列表。 在此字段中,您可以指定用于为新 changelists 生成名称的模板。

      点击 添加占位符按钮 null},{ ,从列表中选择占位符。

    • 功能分支名称格式设置 :当您创建或打开新任务时,IntelliJ IDEA 会提示您创建一个新的 feature 分支。 在此字段中,您可以配置用于生成新功能分支名称的模板。

      点击 添加占位符按钮 null},{ ,从列表中选择占位符。

      使用 小写 和 将空格替换为 选项来配置提示的功能分支名称。

      这些设置在您的 IDE 与问题跟踪器集成时很有用。 例如, DSGN-0001 Add new icon 任务名称将被转换为 dsgn-0001add-new-icon 功能分支名称。

    • 任务历史长度 :IntelliJ IDEA 存储的任务数。

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

    • 启用问题缓存 :优化 IntelliJ IDEA 与 您的 问题跟踪器 之间的同步。 如果使用“慢速”问题跟踪系统,特别建议进行同步。

      IntelliJ IDEA 缓存了从跟踪器加载的问题列表,并不断更新这些问题。 您可以指定应缓存多少问题,以及 IntelliJ IDEA 应多长时间更新一次这些问题的信息。

      任务设置

任务

在 IntelliJ IDEA 中,有两类任务:

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

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

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

打开 tracker 任务

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

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

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

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

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

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

    还可以 搁置当前更改 ,以便稍后再处理。

    打开跟踪器任务

创建本地任务

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

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

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

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

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

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

    还可以 搁置当前更改 ,以便稍后再处理。

查看任务描述

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

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

  2. 打开所需的任务并按 Ctrl+Q ,即可在 IntelliJ IDEA 中打开任务描述。

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

查看已关闭的任务

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

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

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

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

关闭任务

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

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

删除任务

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

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

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

    请使用 Shift 键(用于相邻项目)或 Ctrl 键(用于非相邻项目)进行多选。

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

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

时间跟踪

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

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

安装时间跟踪插件

此功能性依赖 时间跟踪插件,您需要安装并启用该插件。

  1. 按 Ctrl+Alt+S 打开设置,然后选择 插件。

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

启用时间跟踪

  1. 按 Ctrl+Alt+S 打开设置,然后选择 工具 | 任务 | 时间跟踪。

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

  3. (可选)更改 暂停延迟 值。

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

跟踪时间

  • 点击 自动模式 进行自动时间记录。

    要进行手动时间跟踪,请点击 活动任务的开始时间。 要停止手动时间追踪,请点击 停止活动任务的时间。

将时间日志发送到跟踪器

  1. 请点击 将工作项发布到缺陷跟踪器 将项目导出到缺陷跟踪系统 在 时间跟踪 工具窗口。

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

2026年 11月 3日