通义灵码安装失败主因是环境配置问题而非插件本身：vs2022 17.10+“已计划更改”属微软自动更新器死锁bug，需结束相关进程、清理三处缓存、用阿里云离线包以管理员身份安装；idea“plugin is incompatible”源于版本低于2022.3或eap通道导致api不匹配；vs code在win10 ltsc报错系缺失.net 4.8与vc++运行库，须按序安装并禁用program compatibility assistant服务。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
通义灵码在 Visual Studio、IntelliJ IDEA 或 VS Code 中安装失败，不是插件本身有问题，而是环境配置、版本匹配或系统服务干扰导致的——你看到的“已计划更改”“Plugin is incompatible”“Extension host terminated”等提示，背后都有明确可解的路径。
VS 2022 安装卡在“已计划更改”
这是 VS 2022 17.10+ 版本中自动更新器的已知死锁 BUG，微软已在 Developer Community 中确认，但未修复。强行重试只会反复失败。
第一步：打开任务管理器 → 结束所有 devenv.exe、VSIXInstaller.exe、lingma.exe 进程。
第二步：删除三处残留缓存：
① 【%LocalAppData%\Microsoft\VisualStudio\17.0_*\ComponentModelCache】
② 【%LocalAppData%\Microsoft\VisualStudio\17.0_*\Extensions\Alibaba-Cloud*】
③ 【C:\Users\你的用户名\.lingma】
第三步：从阿里云官方源下载离线包（千万别用 VS Marketplace 在线安装）：
VS2022 用户直链：tongyi-lingma-vs2022-latest.vsix
第四步：右键该 .vsix 文件 → 选择“以管理员身份运行”，等待弹窗提示“安装成功” → 重启 VS 一次即可启用。
【绝对不要用命令行执行 vsixinstaller.exe 安装！】 VS2022 的 CLI 安装器存在静默失败逻辑，90% 情况下不报错也不生效，只在日志里埋个空行。
IDEA 手动安装后显示“Plugin is incompatible”
这不是网络问题，是插件包与 IDEA 底层 API 版本硬性不匹配。2021.x 和 2022.1 等旧版 IDEA 根本没有通义灵码所需的 Language Server Protocol v3.16 支持能力。
方法一：确认当前 IDEA 版本是否 ≥ 2022.3
Help → About → 查看右上角版本号。若为 2021.3.3 或更早，必须升级；若为 2022.2.x，也需升至 2022.3.1+。
方法二：检查是否误启 EAP（预览通道）
Settings → Appearance & Behavior → System Settings → Updates → 查看 Update channel 是否为 “Stable”。EAP 版本含实验性 API，通义灵码正式包无法识别其签名结构，会报 Plugin signature verification failed。
方法三：离线安装时校验插件包完整性
下载完成后，用 PowerShell 运行：Get-FileHash tongyi-lingma-*.zip -Algorithm SHA256，比对官网公布的哈希值。U 盘拷贝或内网传输极易导致 ZIP 文件末尾截断，CRC 校验失败则安装必然回滚。
VS Code 在 Win10 LTSC 上报“Extension host terminated”
LTSC 系统精简掉了通义灵码运行所依赖的两个底层组件，不是插件坏了，是系统缺零件。
通义灵码 Linux版是阿里云推出的一款AI智能编码助手，专为Linux开发者设计。它支持在Linux操作系统下的JetBrains IDEs、Visual Studio Code等主流集成开发环境中运行。该工具基于通义大模型，提供代码智能生成、实时续写、单元测试生成、代码优化以及研发智能问答等功能，旨在帮助Linux用户在编码过程中提升效率。
先装 .NET Framework 4.8 Developer Pack，再装 Visual C++ 2015–2022 Redistributable（x64），顺序不能颠倒——VC++ 运行库依赖 .NET 的基础类型注册表项，反序安装会导致 DLL 调用链断裂，插件启动即崩溃。
装完必须重启电脑，否则 PATH 和注册表缓存未刷新，VS Code 仍读不到 vc_runtime.dll。
禁用 Program Compatibility Assistant Service：
Win+R → services.msc → 找到“Program Compatibility Assistant Service” → 右键属性 → 启动类型设为【禁用】→ 点击【停止】→ 确定。
【这一步跳过，后续所有操作都无效】 该服务会在你点击“Install”瞬间注入兼容性拦截，哪怕你已关闭杀毒软件。
LTSC 2019 用户额外操作：右键 VS Code 主程序（Code.exe）→ 属性 → 兼容性 → 勾选“以兼容模式运行” → 选择 Windows 8 → 应用。Electron 沙箱机制在 LTSC 2019 内核下存在权限降级缺陷，此设置可绕过白屏和 Failed to fetch 错误。
IDEA 安装后登录提示“本地服务启动失败”
根本原因是插件尝试写入默认存储路径（通常在 C:\Users\xxx\.lingma）时被系统安全策略拒绝，尤其常见于企业域控环境或启用了 Windows Defender 应用控制（WDAC）的机器。
第一步：卸载现有通义灵码插件。
第二步：重启 IDEA，清空残留句柄。
第三步：重新安装插件，但安装完成不要立刻登录。
第四步：进入 Settings → Tools → Tongyi Lingma → 修改 Local Storage Path 为 D:\lingma 或其他非系统盘路径。
第五步：进入该新路径（如 D:\lingma），右键文件夹 → 属性 → 安全 → 编辑 → 选中 Users → 勾选“完全控制” → 确定。
第六步：重启 IDEA，再点击登录按钮。
