通义灵码可在WebStorm 2024.2.4+免费安装，需先确认版本及系统兼容性，再通过Settings→Plugins搜索安装或命令行/离线方式安装，重启后底部出现蓝色鲸鱼图标即启用成功。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
想在WebStorm里用上通义灵码的AI编程能力，但卡在插件安装这一步？WebStorm 2024.2.4及以上版本已全面支持非商业免费使用，只要IDE版本够新、网络通畅、操作路径正确，5分钟内就能完成安装并登录启用。
确认WebStorm版本与系统兼容性
打开WebStorm，点击 Help → About（macOS为 WebStorm → About WebStorm），查看当前版本号。若显示低于【2024.2.4】，必须先升级——旧版本无法加载通义灵码最新插件，即使强行安装也会在启动时报“Plugin not compatible”错误。
检查操作系统：Windows 7+、macOS 12+ 或主流Linux发行版均可运行，无额外依赖。
从JetBrains插件市场一键安装
方法一：图形界面安装（推荐新手）
1. 点击 File → Settings（macOS为 WebStorm → Preferences）→ 左侧 Plugins；
2. 切换到 Marketplace 标签页，在搜索框输入“通义灵码”或“TONGYI Lingma”；
3. 找到官方发布的插件（开发者为 Alibaba Cloud），点击 Install；
4. 安装完成后，弹窗提示“Restart IDE”，务必点击 Restart，不能仅 Reload Window。
方法二：命令行静默安装（适合批量部署或CI环境）
关闭WebStorm后，在终端执行：
webstorm64.exe installPlugins com.alibaba.tongyi.lingma（Windows）
./webstorm.sh installPlugins com.alibaba.tongyi.lingma（macOS/Linux）
【插件ID必须准确，错一个字符都会失败；该命令需在WebStorm安装目录的bin/子目录下运行】
离线安装全流程
第一步：下载离线包
访问JetBrains Marketplace 搜索“TONGYI Lingma”，进入插件详情页 → 点击右侧“Download plugin”按钮，保存ZIP文件（如tongyi-lingma-2.12.0.zip）。
第二步：本地导入
Settings → Plugins → 点击右上角齿轮图标 → 选择“Install Plugin from Disk…”→ 定位并选中刚下载的ZIP文件 → 点击 OK。
第三步：重启IDE
重启后，观察IDE底部状态栏右侧是否出现蓝色鲸鱼图标（通义灵码标识）；若未出现，打开 Settings → Plugins → 已安装列表，确认插件状态为 Enabled；如显示 Disabled，请手动勾选启用。
