通义灵码Mac安装指南：VS Code配置详解
讨论几个通义灵码在Mac系统部署时经常被忽视的关键点。流程本身不复杂，但某些细节极易引发故障——例如网络波动导致扩展安装失败，或者安装后核心功能无法响应。直接切入实操环节。
首要前提：VS Code版本必须≥1.75。版本不足时，通义灵码的AI推理引擎无法正常加载，表现为图标持续灰色且点击无任何反馈。在Mac终端执行 code --version 即可查询当前版本；若低于1.75，请从官网下载最新版覆盖安装。低版本不仅功能受限，后续升级也会频繁报错。
VS Code就绪后，建议先安装中文语言包：按下 ⌘ + Shift + X 打开扩展侧边栏，搜索“Chinese”，选择“Chinese (Simplified) Language Pack”安装。此步骤非强制，但能大幅提升后续操作的直观性，避免语言障碍。
确认VS Code基础环境
在Mac终端运行 code --version 确认VS Code版本；若低于1.75，请立即下载最新版覆盖安装。旧版本会导致通义灵码AI推理模块失效，图标持续灰色且无法交互。
启动VS Code，按 ⌘ + Shift + X 打开扩展面板，搜索“Chinese”并安装最新版“Chinese (Simplified) Language Pack”，以便在中文界面下完成后续配置。
安装通义灵码插件（两种可靠方式）
根据网络状况选择安装方式：网络稳定时优先使用VS Code扩展市场在线安装；若网络受限或反复失败，则手动安装VSIX包。两种方法均有效，但关键步骤：安装完成后，务必完全退出VS Code（非仅关闭窗口），然后重新启动，否则插件无法正常激活。这一步常被遗漏，导致部署失败。
方法一：通过VS Code扩展市场安装（推荐网络稳定场景）
在扩展面板搜索框输入 【TONGYI Lingma】 → 确认发布者是 【Alibaba Cloud】 → 点击“Install”按钮 → 安装完成后关闭并重新启动VS Code。
方法二：手动安装VSIX包（网络受限或市场安装失败时的备选方案）
访问正式下载页面 → 滚动至页面底部 → 点击“VS Code插件下载” → 选择“TONGYI Lingma-VS Code Latest”下载VSIX文件 → 回到VS Code扩展面板右上角点击“⋯”→ 选择“Install from VSIX…” → 定位并选中已下载的.vsix文件 → 安装成功后，【必须完全退出VS Code（非仅关闭窗口），再重新启动】。
登录并启用核心功能
插件安装完成后，下一步是登录阿里云账号以激活全部功能。但常见疏漏：首次登录后默认模式为普通模式，若需调用Serverless Spark等云服务集成能力，必须手动切换至 【Agent 模式】。
操作步骤：点击VS Code右下角通义灵码图标；若图标未显示，按 ⌘ + Shift + P 输入“Lingma: Login”并回车触发。浏览器自动跳转至阿里云登录页面，使用中国站账号完成认证。登录成功后返回VS Code，状态栏图标变为蓝色并显示“已登录”。
验证配置是否成功：按 ⌘ + Shift + L 打开智能问答窗口，输入“你好”；若收到AI回复，即表示配置完成。
重要提醒：首次登录后，务必在设置中将模式切换为 【Agent 模式】（点击状态栏灵码图标→Settings→Mode→Agent），否则Serverless Spark等云服务集成能力不可用。
根据操作案例统计，约80%的配置失败集中在两个环节：安装后未完全退出重启、Agent模式未切换。牢记这两点，其余步骤均可顺利推进。