在 macOS 上安装通义灵码（TONGYI Lingma）其实非常简单，系统要求不低于 macOS 10.15（Catalina）或更高版本，IDE 也需满足版本门槛——VS Code 最低 1.70，JetBrains 系列至少 2020.3。确认这些条件后，你可以通过插件市场直接安装或使用离线包（VSIX/ZIP）部署，最后用阿里云账号扫码登录即可激活 AI 代码生成能力。

总体流程：先检查环境，再安装插件，最后登录启用。下面一步步详细讲解，请按顺序操作。如果系统或 IDE 版本不达标，即使装好插件也可能看不到图标、无法正常启动——这个坑我遇到过很多次。

确认系统与 IDE 环境

打开终端，输入 sw_vers 查看 macOS 版本号。若低于 10.15，需要先升级系统。VS Code 用户可以按 Cmd+Shift+P 并输入 Help: About 查看版本，低于 1.70 的话请前往官网下载最新版。JetBrains 系列（IntelliJ IDEA、PyCharm 等）需确保版本为 2020.3 或更高，旧版本可能无法正常加载插件界面。

这一步绝对不可跳过。【系统或 IDE 版本不足时，插件安装后连图标都找不到，白费功夫】。

在 VS Code 中安装通义灵码（推荐）

方法一：扩展市场直装（最快）
打开 VS Code → 点击左侧扩展图标（或按 Cmd+Shift+X）→ 在搜索框输入 TONGYI Lingma → 找到开发者为 Alibaba Cloud 的官方插件 → 点击 Install。安装后必须重启 VS Code，否则侧边栏不会出现图标。

方法二：VSIX 离线安装（无网络或企业内网适用）
前往通义灵码官网下载适用于 macOS 的 .vsix 文件 → 打开 VS Code → 在扩展面板右上角点击 ⋯ → 选择 Install from VSIX → 定位并选中下载的文件 → 确认安装 → 重启 VS Code。

在 JetBrains IDE 中安装（以 IntelliJ IDEA 为例）

第一步：打开设置
点击顶部菜单栏 IntelliJ IDEA → Settings（macOS）或 File → Settings（Windows/Linux）。

第二步：进入插件管理
左侧面板依次展开 Plugins → 切换到 Marketplace 标签页。

第三步：搜索并安装
在搜索框输入 TONGYI Lingma → 点击结果中的 Install → 等待进度条完成 → 弹出提示后点击 Restart IDE。

注意：如果安装后侧边栏未显示图标，别着急。右键点击活动栏空白区域 → 勾选 Tongyi Lingma，图标就会显示出来。

登录阿里云账号并启用 AI 功能

重启 IDE 后，点击侧边栏的通义灵码图标 → 点击 Login → 页面跳转到阿里云登录页。支持三种方式：
① 扫码登录（推荐，使用支付宝 App 扫码）
② 账号密码登录（账号需已完成实名认证）
③ AK/SK 密钥登录（仅限远程开发或 CI/CD 场景）。

登录成功后，右侧会自动弹出聊天窗口。此时你可以直接输入自然语言需求，例如“写一个读取 JSON 并校验字段的 Python 函数”，按 Enter 即可触发 AI 生成代码。