答案是必须手动在file→project structure→sdks中指定jdk根目录,而非依赖系统path;新建maven项目需右键pom.xml→reload project,并确认maven home path指向本地安装目录且user settings file正确配置。

IntelliJ IDEA 不是装完就能直接写代码的,新手最常卡在 JDK 路径配错、Maven 仓库没生效、新建项目时选错模板这三步上。
IDEA 启动后提示 “No JDK specified” 怎么办
这个报错不是说你没装 JDK,而是 IDEA 没找到它——哪怕系统 PATH 里有 java -version 能跑通,IDEA 仍可能完全忽略。
- 必须手动指定:进入
File → Project Structure → SDKs,点+→JDK,然后选你本地 JDK 的根目录(比如/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home或C:\Program Files\Java\jdk-17.0.1) - 别选 jre 目录,也别选 bin 子目录;JDK 根目录下必须有
bin、lib、jre(或conf)等子文件夹 - Mac 用户注意:如果用 Homebrew 安装过多个 JDK,
which java返回的路径 ≠ JDK 根路径,得用/usr/libexec/java_home -v 17查真实路径
新建 Maven 项目后 pom.xml 报红、依赖不下载
IDEA 默认不会自动导入 Maven 项目,更不会主动拉取中央仓库——它只认你本地已有的 jar,除非你明确告诉它“去联网同步”。
工程问题的自动化迭代实验室。给定一个 idea 或工程问题,自动调研方案、设计实现、验证效果、迭代优化,结果存入 Notion。触发词:"idea-lab"、"实验一下"、"帮我验证"、"迭代优化"、"idea 验证"。当用户提出一个工程问题并希望自动化地调研→设计→验证→迭代时使用此 skill。
- 右键点击
pom.xml→Maven → Reload project(不是 “Generate Sources”) - 检查
Settings → Build → Build Tools → Maven:确认Maven home path指向的是你自己的 Maven 安装目录(不是 IDEA 自带的 bundled 版),且User settings file指向你本地的~/.m2/settings.xml(如有自定义镜像) - 如果一直卡在 “Resolving dependencies”,关掉
Settings → Maven → Importing → Skip tests和Import Maven projects automatically,先手动 reload 再开
运行第一个 Spring Boot 项目时提示 “Command line is too long”
这是 Windows 下的典型问题,IDEA 把 classpath 全拼进启动命令,超了系统限制(约 8191 字符),和代码本身无关。
- 打开
Run → Edit Configurations → Modify options → Add VM Options,勾选Shorten command line - 推荐选
classpath file(不是jar manifest),它会把 classpath 写进临时文件再引用,彻底避开长度限制 - 该选项只对当前 Run Configuration 生效,每个新配置都要单独设
真正麻烦的不是配置步骤多,而是每个环节都依赖前一步的输出是否被 IDEA 正确识别——比如 JDK 配错了,后面 Maven 就根本起不来;Maven 没 reload,Spring Boot 的 auto-config 就不会触发。盯着状态栏右下角的 “Maven importing…”、“Building…” 这些小提示,比看控制台报错更早发现问题。










