不需要单独安装——但必须使用 intellij idea ultimate 2025.2 或更高版本；社区版需手动安装 jetbrains ai assistant 插件，且需检查网络、账号订阅及防火墙设置，并确保项目索引完整。
AI Assistant在2026年是否需要单独安装？
不需要单独安装——但必须确认你用的是 IntelliJ IDEA Ultimate 2025.2 或更高版本（截至2026年8月，最新稳定版为 2026.1）。社区版默认不带该功能，即使升级到2026.1也仍需手动安装插件。
关键判断点：启动IDE后右上角或右侧工具栏有没有一个螺旋状图标（AI Assistant）；没有的话，说明当前环境未启用该能力。
- Ultimate 用户：首次启动
2025.2+版本时会自动提示启用 AI Assistant，点击「Enable」即可，无需额外下载 - 社区版用户：必须进入
Settings → Plugins → Marketplace，搜索并安装JetBrains AI Assistant插件（注意不是第三方“QianWen”或“Cosy”） - 教育用户：用学校邮箱注册 JetBrains 账号后，在
Account → Subscriptions页面可免费获取 Ultimate 授权，比装插件更稳妥
激活失败常见原因和对应检查项
点了启用按钮却一直卡在「Connecting…」或报错 Failed to connect to JetBrains AI service，大概率是以下三类问题之一：
-
网络代理没配对：JetBrains AI 服务域名是
https://api.jetbrains.com，国内用户常因 DNS 或代理规则漏掉该域名。建议在Settings → System Settings → HTTP Proxy中启用「Auto-detect proxy settings」，或手动添加该域名到 bypass list -
账号未绑定或订阅过期：登录的是个人 JetBrains 账号，但未开通 AI 服务订阅（哪怕试用期也要显式点「Start free trial」）。检查路径：
Settings → Tools → AI Assistant → Account -
防火墙/杀毒软件拦截：某些国产安全软件会静默阻止
idea64.exe访问外网。临时关闭后重试，若恢复则需在防火墙中放行 IDEA 进程
如何让 AI Assistant 真正理解你的 Java 项目？
它不是靠“读代码截图”工作的，而是依赖 IDE 已解析的语义模型。如果你发现提问「为什么这个 Stream.collect() 报错？」时它只泛泛而谈，大概率是项目索引没建好。
- 确保 Maven/Gradle 项目已成功导入：右下角状态栏应显示
Building project... Done，而非Importing...或警告图标 - 检查
File → Project Structure → Project中 SDK 和 Language level 设置是否匹配实际代码（比如用了record却设成 Java 8） - 主动触发索引重建：菜单栏
File → Reload project from disk（Maven）或Build → Refresh build configuration（Gradle） - 避免在未加载完整模块的子目录里打开编辑器——AI Assistant 只能访问当前 module 的上下文，跨 module 引用需显式 import 或在根目录打开
试用阶段最值得立刻验证的三个能力
别一上来就问“帮我写个 Spring Boot 微服务”，先用真实小场景验证它是否真正可用：
-
选中一段异常堆栈，按
Alt+Enter→「Explain stack trace」：正确响应应包含错误根源（如NullPointerException具体哪一行触发）、可能原因（空指针来自userService.findById()返回 null）、修复建议（加Objects.requireNonNull()或 Optional 处理） -
光标停在某个方法名上，输入
/docs+ 回车：应直接弹出该方法在官方文档中的链接，且能跳转到对应 Javadoc 页面（非 Google 搜索结果） -
修改一个变量名，等待几秒看是否出现重命名建议：比如把
userList改成users，AI 应推荐userList→users→activeUsers这类渐进式命名，而非随机词
如果这三项中任意一项响应延迟超过 5 秒、内容明显脱节或完全不触发，说明本地上下文索引或服务连接仍有隐性问题，别急着写复杂 prompt。
