通义灵码安装指南：VS Code配置详解

部署通义灵码前，必须先完成插件安装与阿里云账号绑定。这两步缺一不可，否则智能补全、代码生成、自然语言转代码等核心功能均无法启用。

在VS Code环境中使用通义灵码，核心条件只有两个：安装插件并绑定阿里云账号。完成这两步，即可开启AI辅助编程体验。

安装VS Code编辑器

访问 https://code.visualstudio.com/，根据操作系统选择安装包：Windows下载.exe，macOS选择.zip或.dmg，Linux用户根据发行版下载.deb（Ubuntu/Debian）或.rpm（CentOS/Fedora）。

安装过程中务必勾选“Add to PATH”（Windows/macOS）或“将VS Code添加到系统路径”（Linux）。忽略此步骤会导致终端无法识别VS Code命令，引发报错。

安装后不要立即启动，先在终端运行 code --version 检查版本号。确保版本 ≥ 1.75.1，否则通义灵码2.5.0+插件无法正常加载。

安装通义灵码插件

启动VS Code，点击左侧扩展图标（快捷键 Ctrl+Shift+X / Cmd+Shift+X），搜索框输入 TONGYI Lingma，确认发布者为 Alibaba Cloud，点击“安装”。

安装完成后需完全退出VS Code（含后台进程）并重新启动。仅关闭窗口无法触发插件初始化，状态栏的通义灵码图标不会出现。

插件安装方式多样。首选从VS Code插件市场一键安装。若网络受限无法搜索，可前往阿里云官网下载VSIX安装包，在扩展面板右上角“⋯”菜单中选择“从VSIX安装”，加载本地文件即可。

登录阿里云账号并激活服务

登录阿里云账号是激活通义灵码云端服务的关键步骤，操作简单。

第一步：查看VS Code右下角状态栏，找到通义灵码图标（若未出现，请确认上一步已完全重启）。
第二步：点击图标，在弹出面板中选择“登录”。
第三步：浏览器自动跳转至阿里云登录页，使用已实名认证的账号登录。
第四步：返回VS Code，若状态栏图标变为常亮蓝色，鼠标悬停显示“已登录”，即表示绑定成功。

登录步骤不可跳过。未登录状态下，即使安装了插件也无法调用云端模型（如Qwen2.5-Max、QwQ-Plus），仅能使用本地离线补全，准确率不足30%。

登录后首次使用功能（如按Ctrl+Enter唤出对话框），系统会弹出模型授权确认。务必勾选“同意”，方可进入Agent模式。

切换至Agent模式并验证运行环境

点击状态栏通义灵码图标，在弹出菜单中将模式从默认的“Chat”切换为 Agent 模式。

按Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入 Terminal: Select Default Profile，回车，选择bash（macOS/Linux）或Git Bash（Windows）。
正确设置默认终端配置文件至关重要，它决定通义灵码能否读取系统PATH和Python环境。选择错误会导致后续调用ossutil、spark-submit等工具时出现“command not found”错误。

最后验证：新建空文件，输入 // 按回车，观察能否自动补全注释模板；或选中代码右键选择“Ask Tongyi Lingma”，若能正常响应，则说明配置完成。