必须完成插件安装、IDE重启、阿里云账号登录、Agent模式启用四步，缺一不可；VS Code需输英文名搜索并完全重启，IDEA/Android Studio推荐中文全称搜索，登录须用实名主账号。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在VS Code、IntelliJ IDEA或Android Studio中正常使用通义灵码，必须完成插件安装、IDE重启、阿里云账号登录、Agent模式启用四个不可跳过的环节，任意一步缺失都会导致状态栏无图标、右键菜单不出现、快捷键无响应等问题。
VS Code中安装并激活通义灵码
打开VS Code，确认版本号≥1.68：按Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS）→ 输入About → 回车查看；若版本过低，前往code.visualstudio.com下载覆盖安装。
点击左侧扩展图标（或按Ctrl+Shift+X）→ 在搜索框输入【TONGYI Lingma】（必须输英文名，搜“通义灵码”在部分系统下不返回结果）→ 找到发布者为Alibaba Cloud的官方插件 → 点击Install。
安装完成后，【必须完全退出VS Code所有窗口，再重新启动】——仅点击“Reload Window”无法初始化插件后台服务，状态栏不会出现蓝色鲸鱼图标。
重启后，点击底部状态栏蓝色“通义灵码”图标 → 弹出面板中点“立即登录” → 用阿里云主账号扫码或输入账号密码登录 → 登录成功后，点击右上角齿轮图标 → 将模型模式切换为【Agent 模式】。
IntelliJ IDEA或PyCharm中安装通义灵码
方法一：在线安装（推荐网络稳定时使用）
点击File → Settings（macOS选IntelliJ IDEA → Preferences）→ 左侧Plugins → 切换到Marketplace标签页 → 搜索框输入【通义灵码】（注意不是“lingma”或“Tongyi Lingma”，中文全称匹配最准）→ 找到作者为Alibaba Cloud且带官方蓝标的插件 → 点击Install → 安装完毕后关闭设置窗口 → 【必须点击弹出的“Restart IDE”按钮，不能忽略】。
通义灵码 Linux版是阿里云推出的一款AI智能编码助手，专为Linux开发者设计。它支持在Linux操作系统下的JetBrains IDEs、Visual Studio Code等主流集成开发环境中运行。该工具基于通义大模型，提供代码智能生成、实时续写、单元测试生成、代码优化以及研发智能问答等功能，旨在帮助Linux用户在编码过程中提升效率。
方法二：离线安装（解决插件市场空白/卡死）
访问https://plugins.jetbrains.com/plugin/21548-tongyi-lingma → 下载对应IDE版本的.zip包（如2024.1）→ Settings → Plugins → 右上角⚙️ → Install Plugin from Disk… → 选中zip文件 → 点击OK → 【重启IDEA前务必关闭所有项目窗口，否则插件可能加载失败】。
重启后，右侧工具栏出现蓝色六边形+白色L图标 → 单击打开面板 → 点击“登录阿里云账号” → 浏览器跳转至OAuth授权页 → 必须使用【实名认证的阿里云主账号】（子账号、RAM账号会授权失败）→ 授权成功后，IDEA内自动刷新为已登录状态。
Android Studio中快速部署通义灵码
第一步：打开插件管理
Windows：File → Settings（Ctrl+Alt+S）；macOS：Android Studio → Settings（Cmd+,）→ 左侧Plugins → Marketplace标签页。
第二步：精准搜索安装
在搜索框输入【通义灵码】（不要输英文缩写，中文全称识别率最高）→ 找到开发者明确标注为【Alibaba Cloud】的插件 → 点击Install → 接受权限提示 → 等待进度条走完。
第三步：强制重启生效
设置窗口右下角点击Apply → OK → 弹出提示“Restart IDE to enable plugin” → 【必须点“Yes”，点Cancel或Ignore会导致插件静默禁用】。
第四步：登录绑定
重启后，右侧边栏出现蓝色“灵”字图标 → 点击 → 面板顶部点“登录” → 推荐扫码登录（打开手机淘宝/支付宝扫描）→ 登录成功后，任意Java/Kotlin文件中将光标停在方法名上，行号旁即浮现小图标，点击即可触发代码解释或补全。
