通义灵码代码补全失效需按五步排查：一确认是否真中断（输入System.或print(后停顿1.5秒并Ctrl+Space验证）；二检查插件启用状态及Copilot/CodeWhisperer/Tabnine等冲突提示；三排除Windows Defender对项目根目录的拦截；四重置补全服务绑定，含杀进程、启用Registry选项lingma.service.restart.on.startup；五卸载旧插件、官网下载≥v3.12.0新版手动安装。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
通义灵码代码补全突然失效，光标后不再出现灰色预览、Ctrl+Space 无响应、输入变量名或点号后毫无反应——这不是插件掉线那么简单，而是IDE底层服务链被切断，必须按信号层级逐层排查。
第一步：确认是否真“挂了”，还是被静音了
打开任意 .java 或 .py 文件，输入 System.（Java）或 print(（Python），停顿1.5秒。若无任何补全弹窗，再按 Ctrl+Space 强制触发——如果弹出空白框或只有基础语法项（无“Lingma”标识建议），说明补全通道已中断。
注意：右下角 Lingma 图标显示 “Ready” 不代表功能就绪，它只表示插件进程在跑，不代表补全服务已注册进 IDE 的 PSI 解析器。
第二步：检查插件启用状态与冲突提示
进入 Settings → Plugins → 搜索 tongyi lingma → 观察右侧开关是否为蓝色 ON。
若开关灰显或显示 Disabled，【不要直接点启用】——先看插件条目下方是否有红色感叹号或 Conflicts with: Copilot / CodeWhisperer / Tabnine 字样。这是冲突已发生的铁证，强行启用会失败。
点击右上角 ⚙️ → 选择 Show Enabled First → 快速扫视已启用插件列表，重点关掉：GitHub Copilot v1.130+、Amazon CodeWhisperer、Tabnine v4.x。这三者会抢占端口或劫持 AI 功能注册表。
第三步：验证 Defender 是否正在拦截
方法一（自动）：留意 IDEA 右下角是否弹出“建议将项目文件夹添加到 Windows Defender 排除项”的通知。若有，直接点击弹窗里的 添加排除项 按钮，IDEA 会调用系统 API 自动完成配置。
专为资深工程师设计，用于高效日常使用 GitHub Copilot CLI。适用于在规划、提示、审查或链式调用 gh copilot 命令时，探索代码库、起草变更、调试问题或加速工作流，且不偏离架构意图。
方法二（手动）：打开 Windows 安全中心 → 病毒和威胁防护 → 管理设置 → 添加或删除排除项 → 点击“添加排除项” → 选择你的项目根目录（不是.idea文件夹，是包含src/的父级文件夹）→ 确认。
【必须排除整个项目文件夹，仅排除.idea或out目录无效】
第四步：重置补全服务绑定
第一步：关闭所有 JetBrains IDE 实例，打开任务管理器，杀掉全部 java.exe 和 jetbrains* 进程。
第二步：按下 Ctrl+Shift+A → 输入 Registry → 打开 Registry 编辑器 → 找到并勾选 ide.experimental.ui（启用实验性 UI 支持）→ 再搜索 lingma → 找到 lingma.service.restart.on.startup 并设为 true。
第三步：重启 IDEA。启动后观察底部状态栏是否出现 Lingma Service Connected 提示。若仍无，打开 Help → Show Log in Explorer → 拉到最新日志末尾，查找含 Failed to bind port 36510 的行——这意味着端口被占，需返回第二步彻底禁用 Copilot 和 CodeWhisperer。
第五步：强制更新插件本体
进入 Settings → Plugins → 找到 TONGYI Lingma → 点击右侧三个点 → 选择 Uninstall → 重启 IDE。
访问官网 https://tongyi.aliyun.com/lingma/download → 下载最新版 .jar 包（注意版本号 ≥ v3.12.0）→ 关闭 IDE → 进入插件安装目录（Windows 示例路径：C:\Users\[用户名]\AppData\Roaming\JetBrains\IntelliJIdea2025.2\plugins\）→ 删除原有 TONGYI-Lingma 文件夹 → 将新下载的 .jar 文件解压后整个文件夹拖入该目录 → 重新启动 IDEA。
