VSCode 与 Jira 集成可通过三种方式实现:一、安装 Yash Agarwal 发布的 Jira Plugin,配置域名和 API Token 后登录;二、使用 Stefan Lachmann 的 Jira Issue Navigator,设置 baseUrl 和 apiToken 后侧边栏管理问题;三、通过 brew 安装 jira-cli,在内置终端执行命令行操作。

如果您在使用 VSCode 进行开发时,需要实时查看、更新或关联 Jira 中的任务状态,但当前编辑器内无法直接访问 Jira 条目,则可能是由于未配置合适的集成插件或认证机制。以下是实现 VSCode 与 Jira 集成的多种方法:
本文运行环境:MacBook Pro,macOS Sequoia。
一、安装 Jira Plugin for VSCode
该插件提供基础的 Jira 看板浏览、任务搜索及状态切换功能,依赖 Jira Cloud 的 REST API,无需本地服务器部署。
1、打开 VSCode,点击左侧活动栏的扩展图标(或按 Cmd+Shift+X)。
2、在搜索框中输入 Jira Plugin,选择由 Yash Agarwal 发布的官方认证插件。
3、点击“安装”,安装完成后重启 VSCode。
4、按下 Cmd+Shift+P 打开命令面板,输入并选择 Jira: Login,按提示输入 Jira 域名(如 https://yourcompany.atlassian.net)及 API Token。
二、使用 Jira Issue Navigator 扩展
此扩展专为开发者设计,支持在编辑器侧边栏以树状结构展示项目、版本、冲刺和问题,并可双击跳转至 Jira Web 页面。
1、在扩展市场中搜索 Jira Issue Navigator,确认发布者为 Stefan Lachmann。
2、安装后,通过 Cmd+Shift+P 输入 Jira: Open Issue Navigator 启动面板。
3、首次使用需在设置中配置 jira.baseUrl 和 jira.apiToken,Token 需在 Jira 账户设置 → API tokens 中生成。
4、在面板中右键任意问题,选择 Open in Browser 或 Copy Issue Key,便于快速关联 Git 提交信息。
三、通过 VSCode 内置终端调用 jira-cli 工具
该方式不依赖图形界面插件,适合偏好命令行操作的用户,所有交互均在集成终端中完成,支持批量操作与脚本自动化。
1、在 macOS 终端中执行 brew install jira-cli 安装命令行工具。
2、运行 jira configure,依次输入 Jira 实例 URL、邮箱、API Token 及默认项目 key。
3、在 VSCode 内置终端(Cmd+`)中输入 jira list --status "In Progress" 查看当前进行中的任务。
4、使用 jira transition --issue PROJ-123 --status "Done" 直接更新问题状态,无需离开编辑器。






