通义灵码插件在IDEA中卡在“启动中”是因本地服务僵死、缓存污染或域名拦截所致；需强制终止残留进程、删除~/.lingma目录、以管理员权限重启IDEA，并验证核心域名连通性、清理缓存、重装v1.0.2离线包，最后调高-Xmx至4096m或6144m并重启生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
通义灵码插件在 IntelliJ IDEA 中点击启用后长时间卡在“启动中”、右下角状态栏持续转圈、侧边栏无法展开或登录按钮无响应——这并非网络波动临时现象，而是本地服务进程僵死、缓存污染或关键域名被拦截导致的初始化失败。
强制终止残留进程并清空运行目录
第一步：关闭所有 IDEA 窗口，包括后台隐藏的 jetbrains64.exe（Windows）或 java 进程（macOS/Linux）；
第二步：定位并彻底删除 【.lingma】 目录——Windows 路径为 C:\Users\你的用户名\.lingma，macOS/Linux 为 ~/.lingma；
第三步：以管理员身份（Windows）或 sudo 权限（macOS）重启 IDEA，避免因权限不足导致新目录写入失败。
这一步必须做。旧进程残留会持续阻塞新实例拉起，删错位置（比如误删插件安装目录）会导致后续登录态丢失且无法恢复。
验证核心域名连通性
打开终端（Windows 用 PowerShell，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 错误。
公司内网常默认拦截这两个地址，不能只测网页能否打开——浏览器能开不代表 API 可通。若任一失败，需联系 IT 部门将 【lingma-api.tongyi.aliyun.com】 和 【devops.aliyun.com】 加入出口防火墙白名单。
通义灵码 Linux版是阿里云推出的一款AI智能编码助手，专为Linux开发者设计。它支持在Linux操作系统下的JetBrains IDEs、Visual Studio Code等主流集成开发环境中运行。该工具基于通义大模型，提供代码智能生成、实时续写、单元测试生成、代码优化以及研发智能问答等功能，旨在帮助Linux用户在编码过程中提升效率。
清理 IDE 缓存并重置插件状态
方法一：IDEA 内置重置
点击菜单栏 File → Invalidate Caches and Restart → Invalidate and Restart；
方法二：手动触发 Lingma 服务重建
进入 IDEA 设置 → Plugins → 搜索 “Tongyi Lingma” → 若插件未显示为 Enabled，说明加载失败，需卸载后重装；
重装时务必使用 v1.0.2 稳定版离线包，高版本存在与当前 VS Code Stable Channel 的 IPC 协议不兼容问题，会导致 lingma 进程静默崩溃。
调高 JVM 堆内存并重启生效
打开 IDEA 安装目录下的 idea.vmoptions 文件（macOS 路径为 Contents/bin/idea.vmoptions）；
将 -Xmx 参数改为 -Xmx4096m；若项目含大量模块或使用 Spring Boot DevTools，建议设为 -Xmx6144m；
修改后必须重启 IDEA，否则新参数不加载——热加载不触发 JVM 参数重读。
