通义灵码在离线环境中需安装含-jb后缀的专用离线包（如v3.12.0），idea版本须≥2020.3，安装后必须完全退出并重启idea，再通过阿里云账号或accesskey登录激活，否则功能不可用。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在企业内网、金融系统或科研隔离环境中，通义灵码必须脱离云端验证才能启用基础代码补全与注释生成功能，否则插件图标灰显、右键菜单不可用、状态栏始终显示“Lingma: Not Signed In”。
确认IDE版本与插件兼容性
打开IntelliJ IDEA → Help → About → 查看版本号（如2023.3.4）。【必须为2020.3及以上版本】，低于此版本无法加载插件核心模块，安装后重启也不会出现右侧工具栏图标。
访问通义灵码官网下载页，找到JetBrains专用离线包，注意文件名含-jb后缀（如TongyiLingma-3.12.0-jb.zip），v3.13.0起强制联网校验License，离线环境会直接报错退出。
获取并传输离线安装包
在有网的中转机上下载ZIP包，推荐使用Chrome浏览器直链下载，避免第三方镜像站校验失败。下载完成后立即用SHA256校验值比对（官网页面底部提供），【若校验不通过，安装时会出现“Plugin corrupted”错误且无法回退】。
将ZIP包通过U盘或内网SFTP传入目标开发机，路径建议放在桌面或Downloads目录，避免中文路径或空格——IDEA解析插件元数据时对特殊字符敏感，曾有用户因路径含“（测试）”导致插件管理器崩溃。
在IDEA中完成离线安装
第一步：打开IntelliJ IDEA → File → Settings（Windows/Linux）或 IntelliJ IDEA → Preferences（macOS）→ Plugins。
通义灵码 Linux版是阿里云推出的一款AI智能编码助手，专为Linux开发者设计。它支持在Linux操作系统下的JetBrains IDEs、Visual Studio Code等主流集成开发环境中运行。该工具基于通义大模型，提供代码智能生成、实时续写、单元测试生成、代码优化以及研发智能问答等功能，旨在帮助Linux用户在编码过程中提升效率。
第二步：点击右上角齿轮图标 → 选择“Install Plugin from Disk…” → 浏览并选中刚传入的TongyiLingma-3.12.0-jb.zip文件 → 点击OK。
第三步：等待进度条走完，界面提示“Plugin installed”，此时关闭Settings窗口 → 【必须手动关闭IDEA主窗口并完全退出进程，仅关闭标签页无效】。
第四步：重新启动IDEA，右侧工具栏应出现蓝色六边形+白色L图标，若未出现，请检查Plugins列表中是否显示“TONGYI Lingma”且状态为Enabled。
登录阿里云账号激活功能
方法一：点击右侧通义灵码图标 → 点击面板中“登录”按钮 → 自动唤起系统默认浏览器跳转至阿里云登录页 → 输入已有阿里云账号密码完成认证 → 浏览器显示“登录成功”后，IDEA面板自动刷新为已登录态。
方法二：若唤起浏览器失败（常见于无图形界面的Linux服务器），需提前在有网机生成AccessKey：登录阿里云控制台 → RAM访问控制 → 创建AccessKey → 复制AccessKey ID与Secret → 在IDEA中按下Ctrl+Shift+P → 输入“Tongyi Lingma: Login with AccessKey” → 粘贴两段密钥 → 回车确认。
