VSCode拉不出Jira任务主因是认证方式、域名格式、项目权限三者至少一项配置错误：必须用Atlassian官方插件（发布者Atlassian，ID atlassian.jira-and-bitbucket），域名限https://*.atlassian.net，且需在插件中显式启用对应项目。
VSCode 里根本拉不出 Jira 任务？不是插件没装好，而是认证方式、域名格式、项目权限三者中至少一个没对上。
必须用 Atlassian 官方的 Jira and Bitbucket 插件
社区版 jira-plugin 或旧版已归档的 Jira Plugin 只读、不支持 OAuth 2.0、无法更新状态或创建分支。官方插件发布者必须是 Atlassian，扩展 ID 是 atlassian.jira-and-bitbucket。
- 安装后务必点击“重新加载窗口”，否则
Jira:命令不会出现在命令面板 - 如果之前装过其他 Jira 插件，请先禁用或卸载，避免 token 缓存冲突
- v0.24.0+ 才完整支持新版 OAuth 流程；若授权页跳转后出现
error=invalid_request，说明版本太旧，需卸载重装
Jira: Login 卡住或报 401 Unauthorized 的真实原因
不是网络问题，也不是账号错了，而是插件拒绝连接非 https://*.atlassian.net 格式的 URL。自建 Jira Server（比如 https://jira.internal.company）会被静默拦截。
- 确认你的 Jira 实例域名：必须以
https://开头、.atlassian.net结尾，中间不能带路径（如/jira） - 私有部署实例请改用
jira-plugin（Open VSX 上可搜），并在settings.json中手动配置"jira-plugin.serverUrl"和"jira-plugin.token" - OAuth 授权时，必须用**有目标项目访问权限的账号**登录——不能走 SSO 中转页二次跳转，否则权限不继承
Jira: List Issues 返回空列表？检查这三件事
插件默认只拉取“分配给你”且状态为 To Do 或 In Progress 的 Issue，并自动过滤掉你没权限查看的项目。它不拉全量，也不缓存历史。
- 网页端能看到
PROJ-456但插件不显示 → 检查该 Issue 的Assignee是否为你本人，且项目PROJ已加入你的 Jira “Favorite Projects” 列表 - 刚在网页端把状态改成
Done，插件里还是旧状态 → 默认 5 分钟轮询一次，可手动执行Jira: Refresh Issues，或调低设置项"jira-plugin.refreshInterval"（单位秒） - 想看全部 Issue（包括
Unassigned）→ 用Jira: Search Issues输入 JQL，例如project = PROJ AND status != Done
分支名不含 ISS-123- 前缀，就别指望自动关联
插件不会根据 commit message 里的 #ISS-123 或当前文件路径“猜”你在处理哪个工单。唯一被识别的上下文是 Git 分支名。
- 不要手动
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 或网络问题。
