WebStorm内置Jira插件仅支持拉取和关联，不自动同步状态；状态变更需依赖Jira Automation规则或Bitbucket集成触发，如PR合并时自动流转。
Jira 任务在 WebStorm 里没法自动同步状态？不是插件没装对，而是默认配置根本没启用双向绑定。
WebStorm 自带 Jira 插件能做什么
WebStorm 内置的 Jira 插件（不是第三方插件）只负责「拉取」和「关联」，不自动提交状态变更。它能做的事很明确：
- 在编辑器侧边栏显示当前项目关联的 Jira 工作项列表
- 通过
Ctrl+Shift+A→ 输入Open Issue快速打开指定JIRA-123链接 - 在提交 Git 时，自动识别 commit message 中的
JIRA-123并在本地记录关联 - 右键代码文件 →
Associate with Jira Issue手动绑定当前文件与某工作项
但它不会在你把代码 push 到 Bitbucket 后，自动把 Jira 里的 In Progress 改成 Done —— 这个动作必须靠 Jira 的 Automation 或 Bitbucket 的集成规则触发。
为什么“提交后状态不变”是正常现象
常见误解：以为 WebStorm 提交了带 Jira ID 的 commit，Jira 就该自动更新状态。实际链路是断开的：
- WebStorm 只写 commit message，不调用 Jira API
- Bitbucket 收到 push 后，需已配置「Jira integration」并开启
Update issue status on branch/pull request activity - 即使开了，也只响应
pull request merged或branch deleted等事件，不是每次 commit
如果你在 WebStorm 里点了 Submit 按钮但 Jira 状态没变，先确认：Settings → Tools → Tasks and Contexts → Configure Servers 里填的 Jira 地址是否带 /rest/api/3 路径（旧版 /rest/api/2 在新版 Jira 中已弃用，会导致认证失败）。
用大白话操作当前项目的 Git/GitHub——配置 GitHub（装 gh CLI + 登录 + 建仓库）、备份、拉取下载、查询历史、回滚代码、管理分支。当用户用日常语言表达 git 意图时触发（例如"git备份一下""git下载项目""git拉下来""git看看我改了啥""git回退到上一个版本""git新建个分支搞新功能""git合并到主分支""git
真正能驱动看板流转的三个关键点
想让 WebStorm + Jira 看板动起来，得靠外部触发器，而不是 IDE 本身：
- 在 Bitbucket 中为仓库启用
Jira integration，并在「Development panel」设置里勾选Enable development information in Jira - 在 Jira 项目中开启 Automation：创建规则，当
Pull request merged into main时，执行Transition issue动作（比如从In Review→Done） - 确保 commit message 格式为
feat: add login validation (JIRA-456)—— 括号内必须是完整 issue key，不能是#456或issue-456
WebStorm 唯一能帮你省的事，是自动补全 issue key：输入 JIRA- 后按 Ctrl+Space，它会从缓存的最近 20 个 issue 中列出可选项。
容易被忽略的权限和缓存问题
即便所有配置都对，也可能卡在细节上：
- Jira 用户 token 必须有
Browse Projects和Edit Issues权限（仅View Issues不够） - WebStorm 缓存 issue 列表最多 5 分钟，改完 Jira 状态后，要等刷新或手动点击侧边栏顶部的
Refresh图标 - 如果用的是 Jira Service Management（不是 Jira Software），
Tasks and Contexts插件可能无法识别服务请求类 issue，得换用Service Desk专用插件
最常出问题的地方不在 WebStorm 设置里，而在 Jira Automation 规则是否匹配了正确的项目、状态字段名（比如有的自定义工作流把 Done 叫做 Released），这个字段名必须跟 Jira 后台「Workflow editor」里定义的一致。
