需配置Jira和Bitbucket插件、OAuth认证Jira Cloud、创建带权限的App Password绑定Bitbucket、通过Issue Key创建分支、提交信息含Issue Key以自动关联开发记录。

如果您在使用 VSCode 进行代码开发时希望直接关联 Jira 任务与 Bitbucket 仓库操作，但插件未正常响应或功能缺失，则可能是由于插件配置不完整、认证失效或权限未正确授予。以下是实现无缝集成 Atlassian 生态的具体操作路径：

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

一、安装并启用 Jira and Bitbucket 插件

该插件由 Atlassian 官方维护，提供 Jira 问题浏览、状态更新、分支创建及 Pull Request 关联等能力，需确保其为最新稳定版本且已激活。

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

2、在搜索框中输入 Jira and Bitbucket，确认发布者为 Atlassian。

3、点击“安装”，安装完成后点击“重新加载”使插件生效。

二、配置 Jira Cloud 实例连接

插件需通过 OAuth 2.0 或个人访问令牌（PAT）与 Jira Cloud 建立安全通信，配置错误将导致无法加载项目列表或任务详情。

1、按下 Cmd+Shift+P 打开命令面板，输入并选择 Jira: Configure Jira Server。

2、在弹出的输入框中填写您的 Jira Cloud 域名，格式为 https://your-domain.atlassian.net。

3、选择认证方式为 OAuth 2.0 (Recommended)，随后浏览器将自动打开授权页面，登录并允许插件访问。

三、绑定 Bitbucket Cloud 账户

Bitbucket 集成依赖于有效的 App Password，该密码需具备 repository:read 和 pullrequest:write 权限，用于读取仓库信息与创建 PR。

1、访问 https://bitbucket.org/account/settings/app-passwords/，点击“Create app password”。

2、命名密码为 vscode-jira-bitbucket，勾选 Repositories: Read 与 Pull requests: Write。

3、复制生成的密码，在 VSCode 中执行命令 Bitbucket: Configure Bitbucket Server，依次输入用户名与该 App Password。

四、在编辑器中关联 Jira Issue 与当前分支

插件支持基于 Jira Issue Key 自动识别并创建符合规范的分支名（如 `ISS-123-fix-login-bug`），便于后续自动链接 PR 与 Issue。

1、打开一个已克隆的 Bitbucket 仓库文件夹。

2、按下 Cmd+Shift+P，输入并选择 Jira: Create Branch from Issue。

3、从下拉列表中选择目标 Issue，确认后插件将自动执行 git checkout -b 并切换至新分支。

五、在代码提交中嵌入 Jira Issue Key

插件可监听提交消息格式，在符合正则规则（如 `ISS-123: fix typo in README`）时自动向对应 Jira Issue 添加 Git 提交记录链接。

1、确保工作区根目录存在 .jira/config.json 文件，内容包含 "issueKeyRegex": "([A-Z]+-\\d+)"。

2、编写代码后，在源代码管理视图中输入提交信息，开头必须包含有效 Issue Key，例如 ISS-456: update auth middleware。

3、点击“√”完成提交，插件将在数秒内向 Jira Issue 的“Development”面板追加本次提交的 Bitbucket 链接。