github copilot插件在pycharm中需满足账号订阅、版本≥2022.2、网络可达及oauth授权四重条件方可启用；安装须通过marketplace搜索官方插件并重启ide，右下角图标出现后需完成github登录与权限授权，否则无法触发代码补全。
GitHub Copilot 插件在 PyCharm 中不能直接“一键启用”，必须满足账号、版本、网络和授权四重条件，缺一不可。多数人卡在重启后没弹出登录窗口，或右下角图标不出现——这不是安装失败，而是授权流程中断。
确认 PyCharm 版本 ≥2022.2
低版本（如 2021.3 或更早）即使搜到GitHub Copilot 插件，安装后也无法加载或持续报 Plugin not compatible 错误。
- 打开 PyCharm → Help → About 查看版本号
- 若低于 2022.2，必须升级：前往 https://www.jetbrains.com/pycharm/download/ 下载最新稳定版
- 不建议用旧版 + 手动安装 ZIP 包绕过检查——插件后台服务会拒绝连接，表现为无响应或灰色图标
插件安装路径必须走 Marketplace
手动下载 ZIP 安装（Install Plugin from Disk）会导致认证流程缺失，后续无法触发 GitHub 登录弹窗。
- 正确路径：
Settings/Preferences → Plugins → Marketplace
搜索 GitHub Copilot（注意拼写，不是 “Copliot” 或 “Github Copilot”）
- 点击 Install，**不要勾选 “Enable plugin after installation”**（新版 UI 默认已勾，但需确保重启前插件状态为“已安装未启用”）
- 安装完成后，点击右下角 Restart IDE —— 这一步不能跳过，也不能只 reload project
登录失败常见原因与绕过方法
重启后没弹出登录窗口？右下角没出现GitHub Copilot 头像？大概率是以下任一情况：
- GitHub 账号未开通 Copilot 订阅（学生认证需通过 education.github.com 验证邮箱，非仅注册 GitHub）
- PyCharm 所在机器 DNS 被污染，导致 copilot.githubusercontent.com 请求超时（可尝试在终端执行 curl -v https://api.github.com 测试连通性）
- 登录时浏览器跳转后未粘贴 8 位验证码（不是 GitHub 密码，也不是 PAT token）
- 已在其他 JetBrains IDE（如 IntelliJ）中登录过 Copilot，但 PyCharm 缓存了失效凭证：删掉 ~/.config/JetBrains/PyCharm*/options/copy-paste.xml 和 copilot* 相关配置文件再试
验证是否真正生效
光看右下角图标不够，得测真实补全能力： - 新建一个.py 文件，输入 def calculate_，停顿 1 秒
- 如果出现灰色代码建议（如 def calculate_total(items: list) -> float:），说明后端服务已连通
- 若只显示普通 IDE 补全（变量名、函数名），或提示 No suggestions，说明授权未完成或网络策略拦截了 copilot-proxy 请求
- 快捷键 Ctrl+Alt+→（Windows/Linux）或 ⌥⌘→（macOS）可强制触发整行补全，比 Tab 更可靠
真正麻烦的不是安装步骤，而是 GitHub 账号状态和本地网络策略之间那层看不见的握手——很多公司内网或校园网会静默丢弃 Copilot 的 HTTPS 请求，此时换手机热点就能立刻恢复，但没人告诉你该怀疑这个。
