在mac上安装通义灵码需先确认ide类型（vs code、jetbrains系列或独立lingma ide），三者路径不同且不可混用；m1/m2/m3芯片必须选用arm64安装包，vs code版本≥1.75.1、jetbrains ide≥2020.3，安装后须完全重启ide并登录阿里云账号方可启用全部功能。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在Mac上安装通义灵码，需先确认你用的是VS Code、JetBrains系列IDE（如PyCharm、IntelliJ IDEA）还是独立Lingma IDE——三者安装路径完全不同，混用会导致插件不加载、图标不显示、登录按钮灰显等问题，尤其M1/M2/M3芯片必须选ARM64包，否则启动失败。
确认基础环境是否达标
打开VS Code → 点击菜单栏Code > About Visual Studio Code，核对版本号是否≥1.75.1；若用PyCharm/IntelliJ IDEA，进入PyCharm > About查看版本是否≥2020.3。低于此版本将无法加载通义灵码v3.0.0核心模块。【aarch64架构的Mac（如M1/M2/M3芯片）暂不支持Windows版安装包，必须使用原生macOS ARM64版本】。终端执行uname -m确认返回arm64即为aarch64架构。
安装独立版Lingma IDE（原生Mac应用）
第一步：访问通义灵码官网 https://lingma.aliyun.com/，滚动至页面底部，点击Download for Mac ARM64 (Apple Silicon)下载安装包。Intel芯片Mac用户请选择x64版本，否则启动失败。
第二步：打开Downloads文件夹，找到Lingma-darwin-arm64.dmg，右键→Open with→DiskImageMounter；挂载后将Lingma图标拖入Applications文件夹完成安装。
第三步：前往Applications文件夹，双击Lingma启动→出现Welcome界面时，【必须选择VS Code作为安装流】（选Cursor会导致后续插件生态不兼容）→开发模式选Editor Mode→点击Start Now。
统一LLM网关 - 一个API对接70+AI模型，使用单一API密钥即可调用GPT、Claude、Gemini、Qwen、Deepseek、Grok等主流模型。
在VS Code中安装通义灵码插件
方法一：通过扩展市场在线安装（推荐新手）
打开VS Code → 左侧扩展图标 → 搜索框输入“TONGYI Lingma” → 点击第一个官方插件（发布者为Alibaba Cloud）→ Install → 安装完成后必须重启VS Code，否则插件不加载。
方法二：手动安装VSIX包（适用于无网络或企业代理环境）
从官网下载对应VSIX文件 → VS Code中点击扩展页右上角“…”→ 选择“Install from VSIX…”→ 选取下载的.vsix文件 → 完成后重启编辑器。
【跳过重启将导致插件处于未激活状态，所有功能不可用】
在JetBrains IDE（如PyCharm/IntelliJ IDEA）中配置
① 打开PyCharm → Preferences（macOS）或File → Settings（Windows/Linux）→ Plugins → Marketplace标签页 → 搜索“TONGYI Lingma”。
② 找到插件后点击“Install”。
③ 安装进度条走完后弹出提示框 → 点击“Restart IDE”立即重启。
④ 重启后在左侧工具栏找图标，若未显示，右键活动栏 → 勾选“TONGYI Lingma”即可唤出。
方法二（离线安装）：从官网下载macOS专用ZIP包 → Settings > Plugins → 右上角齿轮图标 →“Install Plugin from Disk” → 选取ZIP文件 → 完成后同样必须重启IDE。
首次启动与登录验证
安装并重启后，在VS Code右下角状态栏或PyCharm右侧边栏点击通义灵码图标 → 点击“登录”按钮 → 浏览器自动跳转至阿里云登录页 → 使用已实名认证的阿里云账号扫码登录 → 返回IDE观察状态栏图标是否变为常亮蓝色，且鼠标悬停显示“已登录”。
这一步不可跳过。未登录状态下，即使插件已安装，所有云端模型（如Qwen2.5-Max、QwQ-Plus）均无法调用，仅能使用极简的本地离线补全，准确率不足30%。
