通义灵码代码补全怎么在Python项目使用？

想在PyCharm里用上通义灵码的代码补全，有三个前提条件缺一不可：插件装好、解释器绑对、三个开关全打开。否则，就算你输入def或import，也不会看到那个灰色的补全提示。下面一步步拆开来看。

说白了，就是得先确认Python解释器能正常跑起来，再装上通义灵码插件，最后把三个开关挨个打开——少一个都不行。

确认Python解释器就绪

打开File → New Project，右侧“Python interpreter”下拉框里必须显示一个有效路径，比如Python 3.10或3.11。如果显示“None”或者报错，那就说明解释器没接上。

点一下齿轮图标 → Add… → System Interpreter，然后浏览选中python.exe（Windows）或python3（macOS/Linux）。

新建一个main.py，输入print("hello")，右键 → Run，能正常输出就说明解释器已经就绪。

安装并激活通义灵码插件

方法一：中文精准安装
File → Settings → Plugins → Marketplace，搜索“通义灵码”——注意别搜“lingma”或“tongyi”，那些旧名字容易匹配到失效的插件。认准发布者是Alibaba Cloud、名称带“TONGYI Lingma”的最新版本，直接点Install。

方法二：英文兜底安装
如果中文搜不到，就改成搜“tongyi lingma”，筛选版本≥2.5.4、更新日期在2025年5月之后的条目，避开那些早就停更的1.x老版本。

装完之后点Apply → OK，关掉设置窗口就行。

执行三重开关启用补全

第一步：全局开关
Settings → Languages & Frameworks → Python → Language Server，确保“Enable language server”已经勾上；再进Settings → Editor → General → Code Completion，确认“Autopopup code completion”也是开启状态。

第二步：语言专属开关
Settings → Editor → General → Code Completion → Language-specific Settings → Python，找到“Tongyi Lingma: Enable Auto Completion”，把它设为true。这一步特别容易漏掉，

第三步：会话级开关
启动PyCharm后，右侧边栏应该出现一个蓝色鲸鱼图标（通义灵码的Logo）。如果没出现，就点View → Tool Windows → Tongyi Lingma手动唤出来。第一次打开面板时会弹出登录窗口，用支付宝APP扫码就能完成绑定。

登录成功后，注意状态栏右下角那个灵码图标：
① 点一下它；
② 选择“Enable for this workspace”；
③ 这时候随便打开一个.py文件，输入def hello(，等个1–2秒，灰色的补全提示就应该浮出来了。

验证补全是否生效

新建一个test.py，输入下面这段代码：

def calculate_area(radius):
  

光标停在冒号后面换行处，静等1秒——如果看到灰色的return 3.14 * radius ** 2提示，按Tab接受就对了。要是没反应，说明三重开关至少有一层没打开。

补全建议默认是灰色显示，按Tab接受，按Esc忽略。接受后光标会自动定位到可编辑位置，不用手动调整。