AB
AB
AiBoss

すべてのカテゴリ

チュートリアル

通义灵码

チュートリアル

在 JetBrains、VS Code 与 Visual Studio 中安装并登录通义灵码

面向 JetBrains IDEs、Visual Studio Code 与 Visual Studio 2022/2019 三端，讲清通义灵码插件的安装前准备、插件市场与离线安装包两种安装方式、浏览器登录与 AK/SK 登录两条路径，以及安装后找不到入口、远程开发无法唤起浏览器等常见问题的处理办法。

通义灵码是一款基于通义大模型的智能编码辅助插件，提供行级与函数级实时续写、用自然语言生成代码、生成单元测试、代码优化建议、注释生成、代码解释、研发问答以及 Java 异常报错排查等能力，并针对阿里云云服务与 SDK/OpenAPI 的使用场景做了调优。它目前以插件形式适配 JetBrains IDEs、Visual Studio Code 和 Visual Studio，个人版可免费使用。这篇教程要解决的问题很具体：把插件装进你正在用的 IDE，完成登录，并让补全与问答真正可用。如果你更想先了解这个工具的整体定位与能力边界，可以先看 通义灵码 的工具页，再回到本文按步骤操作。

适合阅读这篇教程的人：已经装好 IDE、希望在不更换开发环境的前提下引入 AI 编码助手的开发者；需要在远程开发环境（Remote SSH、WSL、Docker）或 Web IDE 中使用插件的工程师；以及负责给团队统一安装方式、需要离线安装包的人。文中涉及的版本号、免费策略与支持范围属于易变信息，请以官网当前信息为准。

准备工作

安装之前先确认三件事：操作系统、IDE 版本、账号。三者任一不满足，插件可能装不上，或者装上后无法登录。

操作系统与 IDE 版本要求

IDE操作系统IDE 版本要求
JetBrains IDEsWindows 7 及以上、macOS、Linux2020.3 及以上
Visual Studio CodeWindows 7 及以上、macOS、Linux1.68.0 及以上
Visual StudioWindows 10 及以上Visual Studio 2022 17.3.0 及以上，或 Visual Studio 2019 16.3.0 及以上

JetBrains 侧的兼容范围覆盖 IntelliJ IDEA（旗舰版、社区版、教育版）、Android Studio、CLion、GoLand、PhpStorm、PyCharm（专业版、社区版、教育版）、Rider、RubyMine、RustRover、WebStorm 等。如果你的 IDE 不在这个列表里，可以到 JetBrains 的 IDE 工具查找器中确认。

账号准备

登录通义灵码使用阿里云账号。常规情况下，插件会把你引导到阿里云登录页完成登录；如果所在环境打不开浏览器，则需要提前准备阿里云账号的 AccessKey ID 与 AccessKey Secret。AccessKey 在阿里云控制台中创建，创建时请按最小权限原则处理，不要把密钥写进代码仓库或提交到版本库。

安装包准备（可选）

如果目标机器不能访问插件市场，或者需要批量部署，可以提前下载对应 IDE 的离线安装包：JetBrains IDEs 使用 zip 包，Visual Studio Code 使用 VSIX 包，Visual Studio 2022 与 Visual Studio 2019 各有一个 VSIX 包。下载来源以官网当前提供的地址为准。

操作步骤

第一步：在 JetBrains IDEs 中安装

以 IntelliJ IDEA 为例，两种安装方式任选其一。

方式一：从插件市场安装

  1. 打开 IntelliJ IDEA 的设置窗口。
  2. 进入插件（Plugins）页面，在市场中搜索 TONGYI Lingma。
  3. 找到通义灵码后单击安装。
  4. 安装完成后重启 IntelliJ IDEA。

方式二：用离线 zip 包安装

  1. 下载 JetBrains IDEs 对应的 zip 安装包。
  2. 打开 IntelliJ IDEA 的设置，进入插件管理。
  3. 在插件管理页面的设置下拉菜单中，选择从本地安装插件。
  4. 选中下载好的 zip 文件完成安装。
  5. 安装完成后重启 IntelliJ IDEA。

第二步：在 Visual Studio Code 中安装

方式一：从扩展市场安装

  1. 打开 Visual Studio Code 的扩展窗口。
  2. 搜索 TONGYI Lingma。
  3. 找到通义灵码后单击安装。
  4. 安装完成后重启 Visual Studio Code。

方式二：用 VSIX 包安装

  1. 下载 Visual Studio Code 对应的 VSIX 安装包。
  2. 打开扩展面板，单击更多按钮。
  3. 在下拉菜单中选择「从 VSIX 安装」。
  4. 选中下载好的 VSIX 文件完成安装。
  5. 安装完成后重启 Visual Studio Code。

重启后如果侧边导航栏看不到通义灵码入口，把鼠标移到侧边导航栏上右键，在菜单中勾选通义灵码，入口就会重新出现在侧边栏。

第三步：在 Visual Studio 中安装

方式一：从扩展市场安装

  1. 打开 Visual Studio 顶部的「扩展」菜单，进入「管理扩展」窗口。
  2. 搜索 TONGYI Lingma。
  3. 找到通义灵码后单击安装。
  4. 安装完成后重启 Visual Studio。

方式二：用 VSIX 包安装

  1. 先关闭已经打开的 Visual Studio 2022 或 Visual Studio 2019。
  2. 下载与你的 Visual Studio 版本对应的 VSIX 安装包。
  3. 双击该 VSIX 文件，按安装向导提示完成安装。
  4. 重新打开 Visual Studio。

第四步：登录账号

登录有两条路径：浏览器登录（推荐）与 AK/SK 登录。先判断自己属于哪种情况，再按对应步骤操作。

路径一：通过阿里云登录页登录

  1. 在插件中找到登录按钮。JetBrains IDEs 与 Visual Studio Code 中，登录按钮位于通义灵码智能问答窗口内；Visual Studio 中则从顶部导航的「工具」菜单进入通义灵码，再单击登录。
  2. 单击登录后会自动跳转到阿里云登录页。
  3. 在阿里云登录页完成登录。RAM 用户请使用 RAM 用户登录页面。
  4. 页面显示登录完成后，回到 IDE 插件端即可开始使用。

路径二：使用 AccessKey 登录

以下场景通常无法打开阿里云登录页，需要用 AK/SK 登录：使用 Remote SSH、WSL、Docker 等远程开发环境；使用 Visual Studio Code 的 Web IDE；使用基于 Visual Studio Code 开源版本构建、且对接了 Open VSX 的 Web IDE；以及其他无法打开登录页的情况。

  1. 前往阿里云控制台创建 AccessKey，取得 AccessKey ID 与 AccessKey Secret。
  2. 在插件中分步输入 AccessKey ID 与 AccessKey Secret。
  3. 如果账号加入了企业，需要选择身份；未加入任何企业时会跳过这一步。
  4. 确认后完成登录。

不同 IDE 的入口位置不同：

  • Visual Studio Code：用快捷键 ⌘ ⇧ P（Windows/Linux 为 Ctrl Shift P）打开命令面板，搜索 TONGYI Lingma，可以看到「使用 AK/SK 登录通义灵码」命令，单击后依次输入 AccessKey ID、AccessKey Secret，选择身份后按 Enter / Return 完成登录。
  • JetBrains IDEs：打开 IDE 设置页面，找到通义灵码插件设置，在未登录状态下即可看到 AK/SK 登录入口，填入 AccessKey ID 与 AccessKey Secret，选择身份（未加入企业无需选择）后单击登录。
  • Visual Studio：暂不支持 AK/SK 登录，只能走浏览器登录路径。

一个完整示例

下面以一台 Windows 机器上的 IntelliJ IDEA 为例，走一遍从零到可用的完整流程。假设 IDE 版本为 2020.3 及以上，机器可以访问插件市场。

  1. 打开 IntelliJ IDEA，进入设置，找到插件页面。
  2. 在市场中搜索 TONGYI Lingma，确认作者与插件名称无误后单击安装。
  3. 安装结束后按提示重启 IDE。
  4. 重启后，在 IDE 侧边导航栏找到通义灵码图标。如果看不到，在侧边导航栏上右键并勾选通义灵码。
  5. 打开通义灵码的智能问答窗口，单击登录按钮。
  6. 浏览器跳转到阿里云登录页，输入阿里云账号完成登录。
  7. 浏览器显示登录完成后，切回 IDE，插件端应处于已登录状态。
  8. 打开任意一个代码文件，把光标放在需要补全的位置，等待行级或函数级建议出现；也可以直接在问答窗口用自然语言描述需求，让插件在编辑器中生成代码。

如果这台机器处于远程开发环境、浏览器无法唤起，把第 5 至 7 步替换为 AK/SK 登录：在 IDE 设置中找到通义灵码插件设置，在未登录状态下填入 AccessKey ID 与 AccessKey Secret，选择身份后单击登录即可。

再举一个 Visual Studio Code 远程场景的流程，便于对照：

  1. 在扩展市场搜索 TONGYI Lingma 并安装，重启编辑器。
  2. 按 Ctrl Shift P 打开命令面板。
  3. 搜索 TONGYI Lingma，选择「使用 AK/SK 登录通义灵码」。
  4. 依次输入 AccessKey ID、AccessKey Secret。
  5. 如账号属于企业则选择身份，按 Enter 完成登录。

注意事项

版本不达标会直接导致安装失败或功能异常。 JetBrains IDEs 需要 2020.3 及以上，Visual Studio Code 需要 1.68.0 及以上，Visual Studio 需要 2022 17.3.0 及以上或 2019 16.3.0 及以上。升级 IDE 前先确认插件是否仍兼容。

Visual Studio 不支持 AK/SK 登录。 如果你的开发机在 Windows 上且无法打开浏览器，Visual Studio 端没有替代登录方式，需要先解决网络或浏览器问题。

远程开发与 Web IDE 优先考虑 AK/SK。 Remote SSH、WSL、Docker 环境，以及 Visual Studio Code 的 Web IDE、基于开源版本构建并对接 Open VSX 的 Web IDE，通常无法完成浏览器跳转登录，直接走 AK/SK 路径更省事。

AccessKey 属于敏感凭据。 创建时遵循最小权限原则，不要硬编码进项目文件，也不要提交到代码仓库；一旦怀疑泄露，应立即在控制台禁用并轮换。

安装后找不到入口先检查侧边栏设置。 Visual Studio Code 中入口可能被隐藏，在侧边导航栏右键勾选通义灵码即可恢复。

双模引擎的适用范围不同。 插件支持极速本地模型与云端大模型两种补全方式，可一键切换。极速离线模型覆盖 Java 与 Python，具备单行补全能力；云端大模型具备函数生成能力。网络受限或对补全强度有不同要求时，按场景切换即可。

语言与能力范围。 支持 Java、Python、Go、C#、C/C++、JavaScript、TypeScript、PHP、Ruby、Rust、Scala、Kotlin 等主流语言；异常报错智能排查目前面向 Java。单元测试生成覆盖 JUnit、Mockito、Spring Test、unit test、pytest 等框架。

免费策略与配额以官网为准。 个人版目前可免费使用，但计费方式、可用模型、配额上限与支持范围都可能调整，使用前请查阅官网当前信息，不要以本文描述作为长期依据。

离线安装包要与 IDE 版本匹配。 Visual Studio 2022 与 Visual Studio 2019 的 VSIX 包不同，JetBrains 侧使用 zip 包、Visual Studio Code 侧使用 VSIX 包，混用会安装失败。

戻る