通义灵码自动补全不触发，根本原因是“Enable auto code completion”开关默认关闭且未手动开启，需在Settings → Tongyi Lingma → Code Completion中勾选；同时须满足IDE版本≥2023.2、插件版本≥4.12.0、账号登录有效、对应语言支持已启用、MCP服务正常运行及非节电模式等前提条件。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
通义灵码在PyCharm或IntelliJ IDEA里敲完点号、空格、回车后始终不弹出补全建议，状态栏图标灰暗无响应，不是模型慢，而是关键开关被跳过或环境条件未满足。
确认插件已启用且版本兼容
进入 File → Settings → Plugins（macOS为 PyCharm → Preferences → Plugins），在搜索框输入「tongyi lingma」；
检查右侧是否显示 Enabled 和 Installed，版本号必须 ≥ 4.12.0；
若显示「Download」而非「Update」，说明你装的是旧版插件——【官方明确要求 PyCharm 2023.2+ / IDEA 2023.2+ 才支持自动补全事件监听】，低版本IDE即使手动安装最新插件也无法注册补全钩子；
可通过 Help → About → Build number 验证IDE实际版本。
打开自动补全总开关
方法一：直达设置路径
进入 Settings → Tongyi Lingma → Code Completion，勾选 Enable auto code completion；
方法二：快捷入口
点击右下角状态栏通义灵码图标 → 弹出菜单中确认「Auto Completion」已点亮为蓝色；
【该选项默认关闭，装完插件不会自动生效，必须手动开启】；关闭状态下，无论输入什么都不会触发AI补全，且无任何提示。
验证账号登录与Token有效性
第一步：确认已登录
打开 Tools → Tongyi Lingma → Sign in with Alibaba Cloud，扫码完成授权；
第二步：检查Token是否过期
登录后不要直接写代码，先打开 Help → Diagnostic Tools → Debug Log Settings，添加 logger：com.aliyun.tongyi.lingma，级别设为 DEBUG；
第三步：复现并查日志
在任意Python文件中输入 print( 或Java中输入 System.out.，随后立即打开 Help → Show Log in Explorer，搜索 access_token_expires_at 字段——若时间戳早于当前时间，说明token已失效，需重新登录。
排除节电模式与语言支持干扰
PyCharm顶部菜单栏若显示「Battery Saver Mode」已启用，立刻点击关闭；
进入 Settings → Tongyi Lingma → Language Support，确认当前编辑文件的语言（如Python、Java）对应的复选框已被勾选；
这一步常被忽略：即使插件全局开启，若Python支持未打勾，.py文件里敲 requests. 也绝不会触发补全。
检查MCP服务是否正常启动
第一步：查看状态栏图标
若右下角完全不显示「tongyi」图标，说明MCP语言服务器未启动；
第二步：检查服务文件
Windows用户打开资源管理器，访问 %userprofile%\.qwen\mcp-server\；macOS/Linux用户终端执行 ls -l ~/.qwen/mcp-server/，确认存在 qwen-mcp-server 可执行文件及 lib/ 目录；
第三步：测试端口连通性
运行 curl -v http://localhost:3000/health 或 telnet localhost 3000，返回HTTP 200或连接成功即证明MCP服务可达；
若失败，查看 Help → Show Log in Explorer 中的 mcp.log，搜索 failed to start mcp server 或 connection refused。
