手动安装Azure Toolkit for IntelliJ提示插件描述符无效如何解决

操作存在的问题 #

• 错误操作1：IntelliJ 手动安装插件不需要自行解压下载的zip安装包，自行解压可能破坏插件的文件结构，导致插件描述符读取失败
• 错误操作2：大概率下载的插件版本与你的 IntelliJ IDEA 2021.2.2 版本不兼容，最新版 Azure Toolkit for IntelliJ 已不再支持 2021.x 系列的旧版本 IDE，版本不匹配会直接触发插件描述符无效报错
• 错误操作3：C盘 Program Files 目录属于系统级受保护目录，写入时如果没有管理员权限，可能出现文件写入不完整、损坏的情况

解决步骤 #

1. 先清理错误安装的残留文件：关闭 IntelliJ IDEA，找到之前解压放入插件目录的 azure-toolkit-for-intellij 文件夹，直接删除避免残留影响
2. 下载兼容版本的插件包：在 JetBrains 插件市场的 Azure Toolkit for IntelliJ 版本列表中，筛选出支持 IDEA 2021.2.x 版本的安装包（可选择 v3.52.0 到 v3.67.0 区间的版本，该区间版本均兼容 2021.2.2），不要下载最新版本
3. 执行正确的手动安装操作：
   • 右键点击 IntelliJ IDEA 快捷方式，选择「以管理员身份运行」，避免后续写入权限问题
   • 依次点击 IDE 顶部菜单栏的 File -> Settings -> Plugins
   • 点击插件页面右上角的齿轮图标，选择 Install Plugin from Disk
   • 在弹出的文件选择窗口中直接选中你下载的zip格式插件安装包，无需解压，确认后等待 IDE 加载完成
   • 按照提示重启 IDE 即可生效

内容的提问来源于stack exchange，提问作者Richie