应选纯java项目类型而非gradle或maven模板,配置好jdk,不勾选模板,手动创建无包名的helloworld类并写入标准main方法,运行前确认run configuration中main class、模块和jre版本正确,首次运行需检查console窗口和编译状态。

选对项目类型:Java 或 Kotlin?
IntelliJ IDEA 创建“Hello World”最常踩的坑,是新建了错误的项目类型。不是所有“New Project”选项都适合入门——比如选了 Gradle 或 Maven 模板,会自动生成一堆配置文件和目录结构,反而让新手卡在 build.gradle 报错或 src/main/java 找不到入口上。
- 如果只是想快速验证环境、看控制台输出,直接选
Java(不是Java with Maven,也不是Kotlin/JVM) - 确保 JDK 已配置:新建项目时右下角会显示
Project SDK,如果为None,点右侧齿轮图标 →Add JDK...→ 选你本地的 JDK 路径(如/Library/Java/JavaVirtualMachines/jdk-17.jdk或C:\Program Files\Java\jdk-17) - 不勾选
Create project from template,避免模板强制加App.java和预设包名,容易和你手动写的类冲突
手写 Main 类:别依赖自动生成
IDEA 有时会在新建 Java 项目后自动创建一个 App.java,但它的内容可能是空的、缺少 main 方法,或者包声明(package)与实际目录不匹配,导致运行时报 java.lang.NoClassDefFoundError 或 “Class not found”。
- 在
src目录下右键 →New → Java Class,输入类名HelloWorld(注意大小写,必须与文件名一致) - 手动敲入标准入口:
public class HelloWorld { public static void main(String[] args) { System.out.println("Hello World"); } } - 不要加
package声明,除非你明确建了对应包目录(例如src/com/example)。默认无包(default package)最不容易出错
运行前检查:Run Configuration 别漏掉这三项
点击绿色三角形运行时失败,常见原因不是代码问题,而是运行配置没对:
- 右上角下拉菜单是否显示
HelloWorld?如果不是,点下拉箭头 →Edit Configurations...→ 左侧点+ → Application→ 在Main class栏手动输入HelloWorld(IDEA 通常能自动补全,但偶尔会空着) - 确认
Use classpath of module选的是你当前项目模块(名字通常和项目名一致,不是untitled或带.main后缀的) - 检查
JRE下拉框是否和项目 SDK 一致;如果显示Project default却仍报Unsupported class file major version,说明运行时 JRE 版本低于编译版本,需手动指定匹配的 JDK
第一次运行没输出?先看 Console 标签页和小锤子
点击运行后底部没弹出 Run 窗口,或窗口里空空如也,大概率是以下两种情况:
- 底部工具栏的
Run标签页被关掉了:按Alt+4(Windows/Linux)或Cmd+4(macOS)强制唤出 - 代码有编译错误但没触发构建:观察右上角是否有红色小锤子图标(
Build project automatically关闭时会出现),点它手动编译;或者进File → Settings → Build → Compiler → Build project automatically打开该选项
真正跑通那一刻,Console 里只有一行 Hello World,没有多余日志、没警告、也没异常堆栈——这就对了。后续加依赖、换构建工具、分模块,都是在这基础上叠加的,别一开始就被 gradlew 或 pom.xml 给绕晕。











