通义灵码插件在idea中卡“启动中”本质是本地服务未启动、网络不通或配置损坏，需按进程→缓存→网络→权限四层逐级清理：终止lingma进程、删除.lingma目录、验证两个核心域名连通性、清理ide缓存并调大堆内存。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
通义灵码插件在 IntelliJ IDEA 中长时间显示“启动中”“初始化失败”或卡在登录界面，本质是本地服务进程未成功拉起、网络连通受阻或关键配置文件损坏，必须从进程、缓存、网络、权限四层逐级清理和验证。
强制终止并清空 Lingma 运行环境
这一步跳过所有界面提示，直击根源——Lingma 服务进程可能已僵死但未退出，残留的 .lingma 目录会持续干扰新启动流程。
打开任务管理器（Windows）或活动监视器（macOS），搜索并结束所有含 【Lingma】 或 【tongyi】 字样的进程；
彻底删除用户级 Lingma 配置目录：
Windows：进入 C:\Users\你的用户名\.lingma，直接删除整个 【.lingma】 文件夹；
macOS：终端执行 rm -rf ~/.lingma；
注意：IDEA 不重启时删目录无效，必须先关掉所有 IDEA 窗口再操作；
删除后，以管理员身份（Windows）或 sudo 权限（macOS）重新启动 IDEA，避免因权限不足导致新目录写入失败。
验证网络连通性与白名单状态
灵码不是纯本地工具，它依赖两个核心域名通信，任一不通都会卡在“启动中”。公司内网常默认拦截，不能只测网页能否打开。
方法一：命令行快速探测
打开终端（Windows 用 PowerShell 或 CMD，macOS 用 Terminal），依次执行：
curl -s https://lingma-api.tongyi.aliyun.com/algo/api/v1/ping → 正常应返回纯文本 【pong】；
curl -I -s https://devops.aliyun.com → 响应头中必须含 【HTTP/2 302】 或 【HTTP/1.1 302】，而非 4xx/5xx 或超时；
方法二：手动加白名单（仅企业环境）
若上步失败，联系 IT 部门将以下地址加入出口防火墙白名单：
【lingma-api.tongyi.aliyun.com】 和 【devops.aliyun.com】；
通义灵码 Linux版是阿里云推出的一款AI智能编码助手，专为Linux开发者设计。它支持在Linux操作系统下的JetBrains IDEs、Visual Studio Code等主流集成开发环境中运行。该工具基于通义大模型，提供代码智能生成、实时续写、单元测试生成、代码优化以及研发智能问答等功能，旨在帮助Linux用户在编码过程中提升效率。
切勿尝试用浏览器访问 devops.aliyun.com 来判断——该域名强制跳转，浏览器能开不代表 API 可通。
修复 IDE 运行环境与插件状态
第一步：清理 IDEA 自身缓存
点击菜单栏 File → Invalidate Caches and Restart → Invalidate and Restart；
第二步：确认插件真实状态
进入 Settings → Plugins，搜索 “Tongyi Lingma”，检查是否显示为“Enabled”；若未出现，说明插件未加载成功，需重装；
第三步：手动触发插件重载（不重装）
关闭所有项目 → 进入 Help → Find Action（快捷键 Ctrl+Shift+A）→ 输入 【Reload plugin】 → 选择 “Tongyi Lingma” → 执行；
第四步：堆内存扩容（高频失败点）
若频繁卡住且日志报 OOM，需增大 IDEA 堆内存：
Help → Change Memory Settings → 将 【Xmx】 值调至 ≥2048m → 重启生效。
离线环境下的应急启动
当确定无法联网时，不要反复点击登录按钮，那只会堆积无效请求。必须切换为离线模式并启用本地模型。
方法一：通过配置文件硬切换
编辑 .lingma/config.json（删除后首次启动会自动生成），在根对象中添加：
"offline_mode": true, "model_source": "local"；
方法二：启动后强制降级
IDEA 启动后，点击右下角 Lingma 图标 → 打开 Settings → 关闭 【Use cloud model】 → 开启 【Enable local model】；
注意：本地模型需额外下载约 1.2GB 模型文件，首次启用会卡在“Downloading…”而非“Starting…”，这是正常进度，不可中断。
