答案是必须手动在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，除非你明确告诉它“去联网同步”。
- 右键点击
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…” 这些小提示，比看控制台报错更早发现问题。
