webstorm 使用 github copilot 需满足三条件：版本≥2024.1（2025.3+原生集成）、网络直连github.com/api.github.com/copilot-proxy.githubusercontent.com、github账号已激活copilot订阅；手动触发补全用ctrl+shift+space，chat卡顿需关闭上下文快照。
WebStorm 能用 GitHub Copilot，但不是装上插件就自动生效——它卡在版本、网络、权限三道关上。2026 年当前（4 月），WebStorm 2024.1+ 是硬门槛，低于这个版本即使手动装插件也会静默失败。
WebStorm 版本必须 ≥ 2024.1 才能加载 Copilot 插件
旧版 WebStorm（比如 2023.3）在插件市场搜不到 GitHub Copilot，不是你操作问题，是 JetBrains 插件索引根本没收录该插件的兼容清单。Help → About 里看到的版本号若小于 2024.1，别折腾安装，直接升级 IDE。
- 2025.3+ 版本已原生集成 Copilot，无需额外安装插件
- 2024.1–2025.2 需手动安装：Settings → Plugins → Marketplace → 搜
GitHub Copilot→ Install → Restart IDE - 插件安装后无图标、无菜单项？大概率是版本不匹配，不是网络或登录问题
网络必须直连 github.com + api.github.com + copilot-proxy.githubusercontent.com
公司/校园网只放行 github.com 主页是不够的。copilot-proxy.githubusercontent.com 这个域名负责认证中继，被拦截会导致登录后一直卡在“Loading…”或弹出 Plugin 'GitHub Copilot' requires authentication 错误。
- 检查方式：在终端执行
curl -v https://copilot-proxy.githubusercontent.com，看是否返回 HTTP 200 - 不能用代理软件全局转发，必须让 WebStorm 进程直连这三个域名（或配置 HTTP 代理到 Settings → Appearance & Behavior → System Settings → HTTP Proxy）
- 手动下载
.zip插件包离线安装会失败——Copilot 是运行时动态鉴权，没有联网握手就无法激活
GitHub 账号必须已有 Copilot 订阅权限，登录 ≠ 可用
Tools → GitHub Copilot → Login to GitHub 成功后，如果 Ctrl+Shift+Space 没反应、Chat 打不开、右下角无 Copilot 图标，90% 是账号侧权限未就绪。
- 个人用户：必须已订阅
GitHub Copilot Individual（$10/mo），免费试用已于 2026 年 3 月取消 - 企业用户：确认你的 GitHub 邮箱已被加入组织的 Copilot 计划，且收到过
Copilot access granted邮件 - 学生用户：需完成教育认证，并在 GitHub 个人主页右上角看到紫色
Copilot Student徽章，否则登录成功也无补全能力 - 验证方式：打开
https://github.com/settings/copilot，状态必须是Active，不是Pending approval或Not eligible
补全不触发？别等悬浮提示，手动唤起才是日常用法
Copilot 在 WebStorm 中默认不主动弹窗，尤其在 Vue SFC、TSX、复杂泛型上下文里，光写几行代码等建议容易误判为失效。
- 强制拉出行内建议：光标放在空行或变量名后，按
Ctrl+Shift+Space（Windows/Linux）或Cmd+Shift+Space（Mac） - 重写当前选中代码块：选中代码 → 按
Option+\（Mac）或Alt+\（Win/Linux） - Chat 区域打不开或超时？去 Settings → Tools → GitHub Copilot → Chat，关闭
Include context snapshot（尤其项目含node_modules时必关）
最常被忽略的一点：Copilot 的上下文感知依赖 WebStorm 的项目索引完整性。如果刚打开一个没配置好 tsconfig.json 或 jsconfig.json 的大型前端项目，它可能连基础类型都推导不准——先确保 WebStorm 左下角没有红色索引错误提示，再指望 AI 给出靠谱建议。
