WebStorm 必须通过官方插件市场在线安装 GitHub Copilot，因该插件依赖实时连接 api.github.com 和 copilot-proxy.githubusercontent.com 完成设备码认证与会话续期，离线安装或手动导入 ZIP 包无法触发认证流程，导致插件灰色不可用。
WebStorm 能直接装 GitHub Copilot，但必须走官方插件市场、在线登录认证，离线安装或手动导入 .zip 插件包一定会失败，报错 Plugin 'GitHub Copilot' requires authentication。
为什么不能手动安装 Copilot 插件包？
Copilot 是动态认证型插件，启动时需实时连接 api.github.com 和 copilot-proxy.githubusercontent.com 完成设备码校验和会话续期。仅允许访问 github.com 主页、或只开了 HTTPS 出口但没放行上述两个域名，都会卡在登录后白屏或反复弹出登录框。
- 公司/校园网环境务必提前申请开通
api.github.com和copilot-proxy.githubusercontent.com的出站访问 - 不要从第三方网站下载
GitHub Copilot-*.zip包，再通过Settings → Plugins → Install Plugin from Disk导入——这一步看似成功，实则无法激活 - 重启 WebStorm 后若仍看到灰色的
GitHub Copilot图标且点击无响应，基本就是认证链断了
正确安装流程（2026 年最新路径）
打开 WebStorm → File → Settings（macOS 是 WebStorm → Preferences）→ 左侧选 Plugins → 顶部切到 Marketplace 标签 → 搜索框输入 Copilot → 找到官方插件（作者显示 GitHub）→ 点击 Install → 弹窗提示重启 IDE → 重启后，在菜单栏点 Tools → GitHub Copilot → Login to GitHub。
- 点击
Copy and open会复制设备码并自动打开浏览器；若没跳转，就手动访问https://github.com/login/device，粘贴码提交 - 授权页必须点
Authorize GitHub Copilot plugin，不是“Confirm”或“Continue” - 学生用户此时可顺手去
https://education.github.com/benefits/offers申请免费资格，验证通过后 WebStorm 里会自动生效，无需额外切换订阅
启用后怎么用？关键快捷键和行为逻辑
Copilot 不是全局监听，它只在你**正在编辑的文件中、光标处于有效代码上下文时**才触发建议。比如你在 .js 文件里写函数，输入 function fetchData 后停顿半秒，下方会浮现灰色补全行。
- 按
Tab接受整行建议；→（右箭头）接受当前高亮部分；Esc或↓忽略 - 写中文注释如
// 将数组去重并返回新数组，回车后 Copilot 可能生成return [...new Set(arr)]; - 补全内容不保证正确性：它可能忽略边界条件、用错 API（比如把
Array.prototype.at()写成不存在的.last()），必须人工核对 - 不支持在
settings.json、.gitignore等非编程语言文件中工作
常见失败信号和排查点
如果登录成功但始终不弹建议，别急着重装。先检查这几个真实易漏项：
- 当前文件后缀是否被 WebStorm 识别为对应语言？例如
foo.tsx被识别成Text类型，Copilot 就不会激活 —— 右下角看状态栏语言标识，不对就点它手动选TypeScript JSX - 是否启用了
Power Save Mode？该模式下所有插件（包括 Copilot）被强制禁用 ——File → Power Save Mode确保未勾选 - 代理设置是否干扰了认证？
Settings → Appearance & Behavior → System Settings → HTTP Proxy里若配置了手动代理，需确认其能连通copilot-proxy.githubusercontent.com，否则建议暂时设为No proxy - 组织账号用户注意：若公司统一管理 Copilot 订阅，需确认你的 GitHub 账号已加入对应
GitHub Organization，且管理员已在Settings → Billing and plans → GitHub Copilot中为你分配许可
最麻烦的环节其实是网络策略和身份验证链，而不是安装动作本身。一旦认证通道打通，后续使用基本稳定；但每次 WebStorm 升级大版本（比如从 2025.3 到 2026.1），都得重新走一遍登录，这是目前 JetBrains 端的固定行为。
