通义灵码补全不生效的首要原因是自动补全开关未手动开启，需在settings→tongyi lingma→code completion中勾选enable auto code completion（默认关闭）；同时确认插件已启用、版本≥4.12.0、ide≥2023.2、账号登录且token有效、无插件冲突、qoder cn进程正常运行。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
通义灵码在IDE中敲完点号、空格或回车后毫无反应，状态栏图标灰暗、补全框从不弹出，不是模型慢，而是关键开关被跳过或底层服务未就绪。
确认自动补全开关已开启
该选项默认关闭，装完插件不等于能用——必须手动启用。
方法一：进入 Settings → Tongyi Lingma → Code Completion → 勾选 【Enable auto code completion】；
方法二：点击右下角状态栏通义灵码图标 → 在弹出菜单中确认「Auto Completion」已点亮为蓝色。
注意：关闭状态下，无论输入什么都不会触发AI补全，且无任何提示。
检查插件启用状态与版本兼容性
第一步：打开 File → Settings → Plugins（macOS为 PyCharm → Preferences → Plugins）→ 搜索「tongyi lingma」；
第二步：确认插件状态为 Enabled，右侧显示「Installed」且版本号 ≥ 4.12.0；
第三步：若版本低于 4.12.0，或显示「Download」而非「Update」，说明你正使用旧版插件——【官方明确要求 PyCharm 2023.2+ / IDEA 2023.2+ 才支持自动补全事件监听】，低版本IDE即使安装最新插件也无法注册补全钩子。
Microsoft Copilot是微软推出的AI助手，整合于Windows、Edge、GitHub及Microsoft 365等产品中。它内置于Word、Excel、PowerPoint、Outlook和Teams等应用，通过大型语言模型与Microsoft Graph中的组织数据（如文件、邮件）相结合，提供文档起草、数据分析、会议总结等上下文感知的智能协助，旨在提升工作效率与创造力。
验证账号登录与Token有效性
登录后不要直接写代码，先验证Token是否真正生效：
① 打开 Tools → Tongyi Lingma → Sign in with Alibaba Cloud，扫码完成授权；
② 登录完成后，打开 Help → Diagnostic Tools → Debug Log Settings，添加 logger:com.aliyun.tongyi.lingma，级别设为 DEBUG；
③ 修改任意代码文件触发补全，观察日志中是否出现 [info] token validated 或 [error] token invalid；
若出现后者，需重新登录并确保网络可访问 api.lingma.aliyun.com。
排查插件冲突与端口抢占
GitHub Copilot、CodeWhisperer、Tabnine 等AI类插件会劫持补全通道或抢占本地服务端口。
进入 Settings → Plugins → 点击右上角 ⚙️ → 选择「Show Enabled First」→ 重点禁用以下插件：
• GitHub Copilot（v1.130+ 与 Lingma v1.0.5+ 存在服务端口抢占）
• Amazon CodeWhisperer（会劫持 IDE 的 AI 功能注册表）
• Tabnine（旧版 v4.x 未适配 IDEA 2025 的 PSI 解析器，导致 Lingma 初始化中断）
禁用后重启IDE，再观察状态栏图标是否亮起；若仍不响应，打开 Help → Show Log in Explorer → 查找含「Failed to bind port 36510」的日志行——此时需同时禁用 Copilot 和 CodeWhisperer 再重启。
强制重启Qoder CN本地服务进程
通义灵码依赖独立运行的Qoder CN进程提供本地调度能力，该进程崩溃会导致所有云端通信静默中断。
Windows用户：右键点击任务栏Qoder CN图标 → 选择「退出」；若图标未显示，打开终端执行 【pkill -f Qoder】 强制终止残留进程；
进入 【C:\Users\用户名\AppData\Local\.lingma\bin\对应版本\CPU架构_64_系统\】 目录（例如 win_x64_64），双击运行 Lingma.exe；
等待终端输出「Qoder CN started successfully」后，再回到IDE中点击通义灵码登录按钮——仅重启IDE无法恢复Qoder CN心跳。
