需安装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,并在拉取请求创建时预填充关联任务。










