IntelliJ IDEA 依赖本地已配置的 JDK，启动报错和编译失败多因 JDK 未装好或未正确配置；Community 版免费支持主流 JVM 语言及构建工具，够用除非需 Spring、数据库或前端深度集成。
IntelliJ IDEA 不需要“安装 Java”——它依赖你本地已配置好的 JDK，装错或没配好 JDK 是启动报错、项目编译失败的最常见原因。
下载 IDEA 时选 Community 还是 Ultimate？
Community 版免费、开源，支持 Java、Kotlin、Groovy、Scala 等核心 JVM 语言，javac 编译、JUnit 测试、Maven/Gradle 构建全部可用。除非你需要 Spring Boot 图形化调试、数据库可视化工具、或 Web 前端深度集成（如 Vue/React 智能提示），否则 IntelliJ IDEA Community 完全够用。Ultimate 版需订阅，官网下载页会明确标注 “Free” 或 “Paid”。
启动前必须验证 JDK 是否就绪
IDEA 本身不带 JDK，它运行和编译项目都靠外部 JDK。常见错误包括：
- 双击
idea.exe直接闪退 → 检查系统环境变量JAVA_HOME是否指向一个完整 JDK（不是 JRE），且该路径下存在bin/java.exe和bin/javac.exe - 新建项目后显示 “No SDKs found” 或
Cannot resolve symbol 'String'→ 说明项目未关联 JDK，需手动指定 - 用 Maven 编译报
Unsupported class file major version 65→ JDK 版本太高（JDK 21），而 IDEA 自带的构建器（Bundled Maven）不兼容，需降级 JDK 或更新 IDEA 到 2023.2+
验证方式：终端执行 java -version 和 javac -version，输出版本号应一致，且为 JDK（非 JRE）。
立即学习“Java免费学习笔记（深入）”；
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
首次启动后必做的三件事
跳过登录、跳过插件推荐，进主界面后立即操作：
- 打开
File → Project Structure → Project，在Project SDK下拉框中点击New... → JDK，然后定位到你本地 JDK 的根目录（如C:\Program Files\Java\jdk-17.0.1），不能选到bin子目录 - 在同一页设置
Project language level，建议与 JDK 主版本一致（如 JDK 17 → 选择17 - Sealed types, pattern matching for switch） - 新建项目时，若使用 Maven，在
Build tool → Maven → Maven home path中不要用 “Bundled”，改选本地已安装的 Maven（如C:\apache-maven-3.9.6），避免因版本冲突导致archetype加载失败
中文乱码、控制台日志变方块？
根本原因是 IDEA 默认使用系统编码（Windows 是 GBK），而现代项目普遍用 UTF-8。不改会导致 System.out.println("你好") 输出问号，或 Maven 控制台日志解析异常。
解决方法分两步：
- 全局编码：进入
File → Settings → Editor → File Encodings，把Global Encoding、Project Encoding、Default encoding for properties files全部设为UTF-8 - 控制台编码：进入
Help → Edit Custom VM Options...，在文件末尾追加一行：-Dfile.encoding=UTF-8，然后重启 IDEA
改完后新建的 Java 类默认以 UTF-8 保存，控制台也能正确显示中文日志——但已有文件不会自动转码，需右键文件 → Reload project from disk 或手动转换编码。
真正卡住人的往往不是“怎么点下一步”，而是 JDK 路径多一级、编码少设一项、Maven 用错版本这些细节。IDEA 启动快，但配错 JDK 就等于没装。
