通义灵码插件安装指南

先分清两种形态，安装路径完全不同

很多安装失败其实是形态选错了。通义灵码对外提供两类交付物，安装方式互不相通：

本页两条路径都写。如果你已经在用 VS Code 或 IntelliJ IDEA，选插件路径；如果你只想装一个程序就开始用，选 Lingma IDE 路径。

路径一：VS Code 插件安装

1. 打开 VS Code，进入左侧「扩展」面板（Extensions）。
2. 搜索框输入 Lingma 或 通义灵码。
3. 在结果中确认发布者为阿里云官方发布账号，再点击「安装」。这一步是防装到同名仿冒扩展的关键。
4. 安装完成后，编辑器侧边栏会出现灵码图标，点击进入面板。
5. 面板内点击登录，浏览器会跳转到阿里云账号授权页，完成授权后回到 IDE。
6. 回到编辑器，在任意代码文件里新起一行写注释描述需求，观察是否出现灰色补全建议；出现即代表链路已通。

如果所在网络无法访问 VS Code 扩展市场，可走离线包方式：从官方渠道取得 .vsix 文件，在扩展面板右上角「…」菜单选择「从 VSIX 安装」，选中文件即可。离线安装同样需要登录授权，因为代码补全依赖云端模型推理。

路径二：JetBrains 系列插件安装

官方支持的 JetBrains 产品包括 IntelliJ IDEA、PyCharm、GoLand、WebStorm 等主流 IDE。步骤基本一致：

1. 打开 IDE，进入 Settings / Preferences → Plugins。
2. 切到 Marketplace 标签，搜索 Lingma。
3. 点击 Install，安装完成后按提示重启 IDE（JetBrains 插件通常必须重启才加载）。
4. 重启后在右侧或底部工具窗口找到灵码入口，点击登录并授权。
5. 在代码文件中触发一次补全，确认建议正常返回。

企业内网如禁用了 Marketplace，可在 Plugins 页右上角齿轮菜单选择 Install Plugin from Disk，加载官方提供的插件压缩包。

路径三：Lingma IDE 独立安装

1. 访问通义灵码官网的下载入口，按当前操作系统选择对应安装包。
2. 下载后按常规桌面程序方式安装：Windows 运行安装程序，macOS 将程序拖入应用目录。
3. 首次启动时登录阿里云账号完成授权。
4. 打开一个本地项目目录，等待索引完成后再开始提问，否则回答会缺少项目上下文。

Lingma IDE 与 VS Code 插件可以共存，两者各自独立登录，不共享工作区配置。

安装后没生效？按这个顺序排查

1. 确认已登录。未登录状态下面板通常可以打开，但补全与对话都不会返回结果，这是最高频的"装了但没反应"。
2. 确认 IDE 已重启（JetBrains 尤其）。
3. 确认网络可达。灵码依赖云端推理，公司代理、防火墙、DNS 污染都会导致请求失败。可在终端测试对官方接口域名的连通性，例如 ping lingma-api.tongyi.aliyun.com 与 ping devops.aliyun.com。
4. 确认 IDE 版本在支持范围内。过旧的 IDE 主版本可能不满足插件的最低平台要求，插件市场会直接标记不兼容。
5. 确认没有插件冲突。同时启用多个 AI 补全插件时，补全建议会互相抢占，表现为"偶尔出建议偶尔不出"。临时禁用其他 AI 插件复测即可确认。
6. 看插件日志。VS Code 用「输出」面板切到灵码通道；JetBrains 用 Help → Show Log，搜索报错行。

典型使用场景

• 新机器搭环境：装完 IDE 顺手装灵码插件，登录一次即可跨项目使用。
• 团队统一环境：内网机器走离线包 + 从磁盘安装，避免每台机器都去访问外部市场。
• 临时评估：不想污染现有 IDE 配置时，装独立 Lingma IDE 单独试用，评估完直接卸载程序。
• 多 IDE 并行：后端用 IntelliJ、前端用 VS Code 时，两边各装一次插件，同一账号登录即可。

本页信息来源

• 通义灵码官方站点与文档：https://lingma.aliyun.com/
• VS Code 扩展市场官方发布页（以市场页显示的发布者信息为准）
• JetBrains 插件市场官方发布页

本页不提供版本号、安装包体积、许可证、发布日期与最低系统配置等易过期数据。这些信息请以官网下载页与插件市场页面的实时显示为准。