如果您在使用 VSCode 进行开发时需要直接查看、创建或更新 Jira 工作项，或与 Bitbucket 仓库进行集成操作，则需借助官方或社区维护的插件实现编辑器内闭环。以下是具体配置与使用方法：
本文运行环境：MacBook Pro，macOS Sequoia。
一、安装 Jira and Bitbucket 插件
VSCode 本身不内置 Jira 或 Bitbucket 集成能力，必须通过扩展市场安装兼容插件以启用工作项管理功能。推荐使用 Atlassian 官方维护的 “Jira Plugin” 或经验证的第三方插件 “Jira Task Management”，二者均支持 Jira Cloud 和 Server 版本，并可关联 Bitbucket 仓库。
1、打开 VSCode，点击左侧活动栏中的扩展图标（或按 Cmd+Shift+X）。
2、在搜索框中输入 Jira Task Management。
3、在搜索结果中找到作者为 “kisstkondoros” 的扩展，点击“安装”按钮。
4、安装完成后，重启 VSCode 以加载插件依赖。
二、配置 Jira 账户连接
插件需通过有效凭证访问 Jira 实例，配置过程涉及 API Token 或 Basic Auth 认证，确保权限覆盖项目浏览、任务创建与状态更新等操作。
1、按下 Cmd+Shift+P 打开命令面板，输入并选择 Jira: Configure Jira Server。
2、在弹出的输入框中填写 Jira 实例 URL，例如 https://your-domain.atlassian.net。
3、选择认证方式：若使用 Jira Cloud，选择 API Token；若为自托管 Jira Server，选择 Basic Auth。
4、按提示输入邮箱与对应 Token 或密码，插件将自动验证连接有效性。
三、绑定 Bitbucket 仓库上下文
插件需识别当前打开的本地仓库与远程 Bitbucket 项目的映射关系，以便在提交、分支或 PR 操作中自动关联 Jira Issue Key。该绑定依赖 Git remote URL 解析及手动配置补充。
1、确保当前工作区已初始化 Git 仓库，并添加了 Bitbucket 远程地址（如 git@bitbucket.org:team/repo.git）。
用大白话操作当前项目的 Git/GitHub——配置 GitHub（装 gh CLI + 登录 + 建仓库）、备份、拉取下载、查询历史、回滚代码、管理分支。当用户用日常语言表达 git 意图时触发（例如"git备份一下""git下载项目""git拉下来""git看看我改了啥""git回退到上一个版本""git新建个分支搞新功能""git合并到主分支""git
2、按下 Cmd+Shift+P，执行 Jira: Configure Repository Mapping。
3、在弹出的下拉菜单中选择当前仓库，随后输入对应的 Bitbucket workspace 和 repository slug（例如 team/repo）。
4、确认后，插件将在状态栏显示 Bitbucket linked 提示。
四、在编辑器中创建与查看工作项
插件提供侧边栏视图与命令快速入口，允许用户无需跳转网页即可检索、新建或修改 Jira Issue。所有操作均基于已配置的 Jira 实例和权限范围。
1、点击左侧活动栏中的 Jira 图标，打开 Issues 面板。
2、在搜索框中输入关键词或 Issue Key（如 PROJ-123），列表将实时过滤匹配项。
3、右键某 Issue 条目，选择 Open in Browser 查看完整详情，或选择 Edit Description 直接在编辑器中修改字段。
4、按下 Cmd+Shift+P，执行 Jira: Create New Issue，按向导填写项目、类型、摘要与描述后提交。
五、提交代码时自动关联 Jira Issue
插件支持 Git 提交消息解析，当提交信息包含符合 Jira Key 格式的字符串（如 PROJ-123）时，将自动在 Bitbucket Pull Request 中标记关联 Issue，并同步更新 Jira 中的开发面板。
1、在 VSCode 内打开源码文件并完成修改，使用 Source Control 视图暂存变更。
2、在提交消息输入框中，首行输入 PROJ-123 implement user login flow，确保 Issue Key 位于开头且无空格分隔。
3、点击“√”提交，插件将检测该 Key 并在状态栏显示 Linked to PROJ-123。
4、推送至 Bitbucket 后，对应 PR 页面的“Development”区域将显示该提交及关联的 Jira Issue 状态。
