旧版 JetBrains IDE 支持最新 AI Assistant 插件的最低版本要求是 2024.2.1，低于此版本无法启用官方 AI 功能。若使用 2025 或 2026 版本，强制要求本地运行环境为 JDK 21 或更高，否则核心功能将被禁用。
先说结论：IDE 版本需至少升级到 2024.2.1，推荐 2025.1 及以上以获得更好的兼容性支持。
- 适合场景：希望使用 JetBrains 官方原生 AI Assistant 功能的开发者。
- 先准备：确认操作系统满足 JDK 21 运行环境，尤其是 2025+ 版本用户。
- 验收：在插件市场确认 AI Assistant 状态为已安装且已启用。
命令速用版
无需命令行即可检查版本，但需验证 Java 环境。在 IDE 菜单栏点击 Help > About 查看版本号。对于 2025 及以上版本，在终端执行以下命令确认运行时环境：
java -version
输出需包含 21.x.x 或更高版本。若显示 JDK 17 或 8，需更新环境变量 JAVA_HOME 指向 JDK 21 路径。
为什么会这样
版本限制源于 JetBrains 运行时架构的升级。IntelliJ IDEA 2025 及后续版本基于 JetBrains Runtime 21 (JBR21) 构建，不再兼容旧版 JDK 作为运行时环境。AI Assistant 作为深度集成的内置组件，依赖新运行时提供的 API 与索引能力，旧版 IDE 内核无法加载相关模块。
分步处理
第一步：确认 IDE 版本
打开 IDE，进入 Help > About。若版本号低于 2024.2.1，需前往官网下载最新安装包。2025.1 版本对部分地区网络环境兼容性更好，建议优先选择。
第二步：检查插件状态
进入 Settings/Preferences > Plugins > Installed。查找 JetBrains AI Assistant，确保勾选框已启用。若未找到，说明版本过低或不支持该功能。
第三步：配置运行环境
对于 2025+ 版本，检查系统环境变量。Windows 用户在系统变量中设置 JAVA_HOME 为 JDK 21 路径；macOS/Linux 用户编辑 ~/.zshrc 或 ~/.bash_profile，导出 JAVA_HOME 指向 JBR21 路径。
怎么验证是否生效
重启 IDE 后，观察编辑器右侧是否出现 AI 助手图标，或尝试使用代码补全功能。在设置中搜索 AI Assistant，若能进入配置页面且无报错提示，说明环境验证通过。若授权失败，需检查 IDE 地区设置是否已切换至中国大陆，并关闭网络代理工具以避免 IP 误判。
常见坑
JDK 版本冲突：系统中存在多个 JDK 时，IDE 可能调用错误版本。务必通过终端验证 java -version 输出是否为 21+。
插件未启用：AI Assistant 是内置插件，无需下载，但默认可能未勾选启用。需在插件列表手动开启。
网络授权失败：部分地区用户若开启网络代理，可能导致授权服务器误判 IP 位置。建议暂时关闭代理工具并切换 IDE 地区设置。
常见问题
IDEA 2023 版本能安装 AI Assistant 吗？
不能。官方要求最低版本为 2024.2.1，旧版内核不支持 AI 助手所需的运行时接口。
必须安装 JDK 21 才能使用吗？
取决于 IDE 版本。2024.2.1 版本可能兼容旧运行时，但 2025 及 2026 版本强制要求 JDK 21 或更高作为运行环境。
AI Assistant 需要单独下载插件吗？
不需要。它是 JetBrains 内置插件，在 2024.2.1 及以上版本中默认已安装，只需在插件设置中启用即可。
参考来源
- JetBrains AI Assistant 超全使用教程|从安装到实战，解锁 AI 编程高效体验_jetbrains ai 怎么使用-CSDN 博客
- 别再用旧版了!IDEA 2025 新增 AI Assistant 本地部署入口，安装时漏配这 1 个环境变量将永久禁用核心功能
- IntelliJ IDEA 2026 安装全攻略：从零配置到极速启动，手把手完成 JDK 21+、GraalVM 22 与 AI Assistant 插件一体化部署