配置通义灵码的自动补全时，有一个容易忽视的细节：安装插件并不意味着自动启用。默认情况下，IDE往往只开启了聊天面板，而实时代码补全功能是关闭的——必须手动打开总开关，并完成阿里云账号登录，才能真正让编辑器在编写代码时自动弹出灰色建议，按下Tab键即可一键采纳。

确认插件已安装并完成登录

打开 VSCode 或 JetBrains IDE（如 IDEA），在插件市场搜索「TONGYI Lingma」并安装；安装后重启 IDE，点击右侧工具栏的通义灵码图标，按提示完成阿里云账号登录。未登录状态下，所有补全功能均不可用。

JetBrains 用户请特别注意：必须重启 IDE，仅重载插件是无法生效的。

开启自动补全开关（关键步骤）

VSCode：按下 Ctrl + , 打开设置 → 左侧选择「Extensions」→ 找到「TONGYI Lingma」→ 勾选「Enable Auto Completion」。

JetBrains：File → Settings → Plugins → TONGYI Lingma → 勾选「Enable auto code completion」。

这一步如果遗漏，即便快捷键能触发，编辑器也不会自动出现灰色建议——此开关控制的是“是否监听你的键盘输入”，属于补全功能的总闸门。

验证补全是否生效

新建一个 .py 文件，输入 for i in range( 后停顿半秒，观察是否出现灰色推荐，例如 10):；

再新建一个 .ja va 文件，输入 public void calc，查看是否弹出类似 calculateTotal(int a, int b) 的函数签名建议。

如果没有任何灰色提示，返回上一步检查开关是否已勾选，并确认当前文件类型没有被禁用。

按需调整补全触发方式

方法一：手动触发补全（稳妥可靠）
VSCode 中按 Ctrl+Shift+C（或默认 Alt+P）；
JetBrains 中按 Alt+P 或你自定义的快捷键。

方法二：启用自动触发但排除干扰文件
进入通义灵码配置页 → 找到「Disabled File Types」→ 输入 md,txt,log → 保存。
这样在编写 Markdown 文档时不会弹出补全提示，但 .ja va/.py 文件里仍然保持自动飘灰建议。

注意：逗号必须为英文，写成中文顿号或空格会导致整个配置失效，补全会在所有文件里乱跳。

快速切换补全模式（临时应急）

第一步：在任意代码文件中按一次默认快捷键（如 Alt+P）触发补全；
第二步：观察编辑器右下角状态栏，找到 Lingma 小图标；
第三步：单击该图标 → 选择「Toggle Auto-Trigger」。

切换后，自动飘灰建议立即停止，但手动 Alt+P 仍然可用。这个开关状态会被记住，下次打开 IDE 依然有效。