VS Code安装阿里通义灵码插件详细图文教程

想要在VS Code里用上阿里云出品的免费AI编程助手——通义灵码，准备工作可不能马虎。编辑器版本和账号是两个硬性门槛，缺一不可。

简单来说，你的VS Code版本必须不低于1.68.0，同时手上得有一个阿里云账号。这两个条件不满足，插件装上去了也基本等于摆设。

确认VS Code版本并更新

先看看你的编辑器版本够不够格。按住Ctrl + Shift + P调出命令面板，输入About后回车，版本信息就出来了。

如果版本号低于1.68.0，别犹豫，直接去官网 https://code.visualstudio.com 下载最新的安装包。旧版本对插件的兼容性不太好，一个典型的问题就是Webview界面加载不出来，导致插件图标显示成空白，或者点击根本没反应。

安装新版本时，建议顺手勾选“Add to PATH”这个选项，免得以后在终端里调用VS Code时遇到麻烦。

安装通义灵码插件

安装插件本身，两条路可以走：

方法一：在线市场安装（推荐）
这是最省事的办法。点击VS Code左侧活动栏的扩展图标（快捷键Ctrl+Shift+X），在搜索框里输入TONGYI Lingma。认准发布者是Alibaba Cloud的那个官方插件，然后点击“安装”就行。

方法二：离线安装（网络受限时使用）
如果网络环境不允许，可以去通义灵码的官网下载对应你操作系统的VSIX安装包。回到VS Code的扩展面板，点击右上角的“⋯”菜单，选择“从 VSIX 安装…”，然后找到并选中你刚刚下载的文件即可。

不管用哪种方法，安装完之后，一定要重启一次VS Code。不重启，左侧导航栏根本不会出现通义灵码的图标，后续的登录流程自然也无从谈起。

完成阿里云账号登录

插件装好重启了，接下来就是登录激活。跟着这几步走：

第一步：点击VS Code左侧新出现的那个通义灵码图标，进入插件的主界面。
第二步：找到并点击“Log in with Aliyun Account”这个按钮。
第三步：这时会弹出一个浏览器窗口，请使用你的手机号、支付宝账号或淘宝账号登录。这里有个关键点：不能用微信快捷登录。这个方式目前不被通义灵码的后台服务识别，用了它，你的登录状态会一直卡在“未授权”。
第四步：登录成功后，留意一下VS Code窗口的右下角，通常会弹出一个绿色的提示，写着“Welcome, [你的昵称]”。看到这个，就说明插件已经成功激活了。

验证插件是否正常工作

理论上是激活了，但最好实际检验一下。随便打开一个代码文件，选中一段函数代码，然后右键点击。在右键菜单里，你应该能看到“通义灵码”的选项，选择它下面的“解释这段代码”。

稍等几秒钟，如果一切正常，代码编辑区的右侧会浮动出一个解释窗口，里面会详细说明这段代码的逻辑，并标明编程语言。如果窗口一片空白，或者直接提示“请先登录”，那就说明账号认证可能没同步上。这时可以点击插件界面右上角的头像，选择“登出”，然后重新走一遍登录流程。