需安装Atlassian官方扩展，配置Jira服务器连接与Bitbucket账户授权，启用Issue Linking功能，即可实现Jira任务识别、跳转、状态更新及自动创建关联分支并推送。

如果您在使用 vscode 进行开发时希望将 jira 任务跟踪与 bitbucket 代码仓库操作直接集成到编辑器中，则可能需要配置并启用对应的扩展插件以实现任务关联、分支自动创建、提交信息预填充等功能。以下是实现该联动的具体操作步骤：

本文运行环境：MacBook Pro，macOS Sequoia。

一、安装 Jira and Bitbucket 官方扩展

VSCode 的扩展市场中存在多个第三方实现的 Jira/Bitbucket 集成工具，其中 Atlassian 官方维护的 “Jira and Bitbucket” 扩展提供基础认证与上下文跳转能力。安装该扩展是建立联动关系的前提。

1、打开 VSCode，点击左侧活动栏中的扩展图标（或按快捷键 Cmd+Shift+X）。

2、在搜索框中输入 Atlassian for VS Code，确认发布者为 Atlassian。

3、点击“安装”，等待扩展下载并启用完成。

二、配置 Jira 服务器连接

扩展需通过 API 访问 Jira 实例以获取任务详情和状态变更能力，因此必须完成有效的 Jira 账户认证与实例 URL 设置。

1、按下 Cmd+, 打开设置界面，在右上角点击“打开设置（JSON）”图标。

2、在 settings.json 中添加如下字段：

"jira.baseUrl": "https://your-domain.atlassian.net"

3、保存文件后，按下 Cmd+Shift+P，输入 Jira: Login 并回车，按提示完成 OAuth 流程或输入 API Token。

三、绑定 Bitbucket Cloud 账户

Bitbucket 仓库操作依赖于账户级 API 权限，扩展通过 OAuth 2.0 获取对仓库、分支、拉取请求的读写访问权限，从而支持从 Jira 任务一键创建分支、推送提交等操作。

1、在命令面板中输入 Bitbucket: Login 并执行。

2、浏览器将跳转至 Bitbucket 授权页面，勾选 repository:write 和 pullrequest:write 权限后授权。

3、返回 VSCode，确认状态栏右下角显示 Bitbucket logged in。

四、启用 Jira Issue Linking 功能

该功能允许在当前打开的代码文件中识别 Jira 问题 Key（如 PROJ-123），并提供快速跳转、状态更新与关联提交日志的能力，无需切换浏览器即可查看上下文。

1、确保工作区根目录下存在 .jira/config 文件，或在 VSCode 设置中启用 jira.enableIssueLinking 为 true。

2、在任意代码文件中输入类似 PROJ-123 的字符串，将鼠标悬停其上，出现悬浮卡片即表示识别成功。

3、点击卡片中的 Open in Jira 即可跳转至对应任务页。

五、使用 Jira 创建关联分支并推送

当开发者从 Jira 任务出发启动开发时，可通过扩展自动生成符合命名规范的特性分支，并将其与任务 ID 绑定，便于后续 CI/CD 流水线识别与追踪。

1、在命令面板中输入 Jira: Create Branch from Issue 并选择一个已加载的任务。

2、系统将提示输入分支前缀，默认为 feature/，确认后生成形如 feature/PROJ-123-add-login-validation 的分支名。

3、执行 Git: Push 操作后，Bitbucket 侧将自动检测该分支含 Jira Key，并在拉取请求创建时预填充关联任务。