必须使用 atlassian 官方 jira and bitbucket 插件，通过 oauth 2.0 认证并正确配置域名与项目权限，分支名需含 issue key（如 iss-123-fix）才能实现查、改、关工单及自动关联。
能直接在 VSCode 里查、改、关 Jira 工单，但必须用对插件、配对认证方式、绑对上下文，否则连任务列表都拉不出来。
用 Jira and Bitbucket 插件，不是 Jira Plugin
Atlassian 官方维护的 Jira and Bitbucket 插件（发布者：Atlassian）是当前唯一支持完整工单生命周期操作的 VSCode 扩展。它能读 Issue、更新状态、创建分支、关联 PR，而老版本的 Jira Plugin（已归档）仅支持只读浏览，且不兼容 Jira Cloud 新 OAuth 流程。
- 在 VSCode 扩展市场搜
Jira and Bitbucket，确认发布者是Atlassian，不是第三方仿制版 - 安装后必须点击“重新加载”——否则命令面板里看不到
Jira:前缀的任何命令 - 如果已装过旧版
Jira Plugin，请先禁用或卸载，避免认证冲突和状态缓存污染
OAuth 2.0 是唯一推荐的认证方式
用个人访问令牌（PAT）虽然也能连，但容易因权限粒度粗、过期无提示、日志泄露风险高而中断连接。OAuth 2.0 由 Atlassian 统一鉴权，自动刷新 token，且权限范围可控。
- 执行
Jira: Configure Jira Server后，务必填完整域名：https://your-domain.atlassian.net（结尾不能少/，也不能带路径如/browse） - 选 OAuth 2.0 后，浏览器会跳转到 Atlassian 授权页；必须用**有项目访问权限的账号**登录并授权，不能用 SSO 中转页二次跳转
- 授权完成后，VSCode 不会自动弹窗提示成功——要手动运行
Jira: Refresh Projects，看状态栏是否出现项目列表；若仍为空，检查网络是否拦截了https://auth.atlassian.com
分支名必须含 Issue Key 才能自动关联
插件不会“猜”你当前在处理哪个工单。只有当 Git 分支名严格匹配 ISS-123-something 格式（Issue Key 开头 + 连字符 + 描述），后续提交、PR、状态更新才能被 Jira 自动识别。
- 不要手动
git checkout -b fix-login，而要用插件命令：Jira: Create Branch from Issue - 该命令生成的分支名默认为
ISS-123-description-from-summary，可编辑但不能删掉ISS-123-前缀 - 如果已有本地分支不含 Issue Key，插件无法 retroactively 关联——只能新建分支并 cherry-pick 提交，或手动在 Jira 页面 Link 到该分支
最容易被忽略的是：Jira 项目权限模型和 VSCode 插件权限是两套体系。即使你在网页端能看到某个 Issue，在 VSCode 里看不到，大概率是该项目未在插件配置中显式启用（Jira: Select Project 没点进去勾选），而不是网络或 token 问题。
