必须安装通义灵码插件并绑定阿里云主账号才能使用其功能：idea需2023.3+版本且jdk11+；插件须从marketplace搜“通义灵码”（作者alibaba cloud）或离线安装官方zip包；重启后登录实名主账号完成授权。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在IntelliJ IDEA里用上通义灵码的代码补全、解释、单元测试生成等功能，必须先完成插件安装和阿里云账号绑定——没装插件，右侧工具栏压根不会出现图标；没登录账号，所有AI功能按钮全是灰色不可点，右键菜单里也找不到“通义灵码”子项。
确认IDEA版本与Java环境
打开IDEA → Help → About，确认版本号为【2023.3或更高版本】。低于此版本无法在Marketplace中看到该插件，且部分上下文感知能力不可用。
进入File → Project Structure → Project → Project SDK，确保已配置JDK 11或以上版本。未配置时插件虽能安装，但首次登录会卡在“正在初始化模型服务”，界面无任何报错提示，容易误判为网络问题。
从Marketplace在线安装（推荐）
点击File → Settings（Windows/Linux）或IntelliJ IDEA → Preferences（macOS）→ 左侧Plugins → 切换到Marketplace标签页。
在搜索框输入“通义灵码”，注意不要输成“通义灵码 for IDEA”或英文拼写“Tongyi Lingma”——官方插件名称严格为中文“通义灵码”，其他名称多为第三方仿制，存在账号劫持风险。
找到作者为“Alibaba Cloud”的插件（右下角带官方蓝标），点击Install → 等待进度条走完 → 弹出提示后点击Restart IDE。
【安装完成后必须重启IDEA，否则插件不加载、侧边栏不显示图标】。
手动安装ZIP包（离线/受限网络）
方法一：访问阿里云官方插件页 https://plugins.jetbrains.com/plugin/21548-tongyi-lingma ，点击“Download plugin”获取.zip文件（截至2026年7月最新版为v2.12.0）。
方法二：若官网访问受限，可使用备用链接 https://tongyi-code.oss-cn-hangzhou.aliyuncs.com/jetbrain/tongyi-jetbrains-latest.zip 直接下载，注意核对文件名是否含-jb后缀（如TongyiLingma-2.12.0-jb.zip），这是专为JetBrains IDE优化的版本。
下载后，回到IDEA → Settings → Plugins → 右上角齿轮图标 → Install Plugin from Disk → 选择刚下载的.zip文件 → 点击OK。
⚠️ 这一步不能解压ZIP包——IDE只识别原始压缩包，解压后选文件夹会报错“Invalid plugin archive”。
首次启动与账号绑定
第一步：重启IDEA后，在主界面右侧边栏会出现蓝色六边形+白色“L”字样的通义灵码图标，点击打开面板。
第二步：点击面板中的“登录阿里云账号”按钮 → 自动唤起系统默认浏览器跳转至阿里云OAuth授权页。
第三步：使用【个人实名认证的阿里云主账号】登录（子账号、RAM账号无法完成授权）。
第四步：浏览器显示“授权成功”后，切回IDEA，等待右下角图标由灰色变为蓝色并出现小铃铛标识，表示初始化完成。
