首个java项目需三步到位：jdk版本匹配、utf-8编码统一、main入口识别准确；避免误选maven/gradle，手动配置sdk路径与编码，运行前右键执行main方法。
直接上手创建第一个 Java 项目，关键不是点得多快，而是三处配置一步到位：JDK 版本对、编码统一为 UTF-8、运行入口识别准。漏掉任一环，都会卡在 Cannot resolve symbol 'String'、中文乱码或 Could not find or load main class 这类典型报错里。
选对项目类型，避开 Maven/Gradle 干扰
新手最容易踩的坑是新建时误选 “Maven” 或 “Gradle”。它们自带复杂结构（pom.xml、src/main/java），但第一个 Hello World 完全不需要。
- 启动 IDEA 后点 New Project，左侧明确选 Java（不是 Java Enterprise、Spring Initializr 或 Maven）
- 右侧勾选 Create project from template → 再选 Command Line App，IDE 会自动生成带
main方法的类 - 如果不想用模板，就跳过这步，后续手动建类——但务必保证类名与文件名完全一致（如
HelloWorld.java里必须是public class HelloWorld）
正确配置 JDK，别信“自动识别”
IDEA 不会读取系统 JAVA_HOME，也不保证默认用你装的 JDK。新建项目时若 SDK 显示 No SDK 或版本号灰显，编译必失败。
- 在 New Project 窗口左下角，点击 Project SDK → Add JDK…
- 定位到本地 JDK 根目录：
• macOS 示例：/Library/Java/JavaVirtualMachines/jdk-17.0.x.jdk/Contents/Home
• Windows 示例：C:\Program Files\Java\jdk-21.0.x
注意：不能选到bin子目录下 - 创建后立刻验证：File → Project Structure → Project，确认 Project SDK 和 Project language level 都设为同一版本（如都选 17）
统一 UTF-8 编码，终结中文乱码
控制台输出 你好 变成问号？这不是字体问题，是编码链断裂：IDE 启动参数、编辑器设置、终端环境三者不一致。
- 进 File → Settings → Editor → File Encodings，把以下三项全设为 UTF-8：
• Global Encoding
• Project Encoding
• Default encoding for properties files - 在 Help → Edit Custom VM Options 末尾添加一行：
-Dfile.encoding=UTF-8（改完需重启 IDEA） - Windows 用户额外处理终端：
进 Settings → Tools → Terminal，Shell path 若为cmd.exe，在后面加上：/k chcp 65001 >nul
运行前检查 Run Configuration，别点错按钮
顶部工具栏那个绿色 ▶️ 按钮会复用旧配置，极易指向错误类或空模块，导致 Class not found。
- 把光标放在
main方法内部，右键 → 选择 Run 'ClassName.main()'，IDE 自动创建干净配置 - 若需手动调整，点 Run → Edit Configurations：
• 确保 Use classpath of module 下拉框选中当前项目模块（非空白或灰色项）
• Main class 字段填全限定名，如com.example.HelloWorld，前后勿留空格、点号勿遗漏 - 首次运行成功后改代码不生效？检查是否开启了 Build project automatically（Settings → Compiler → Build project automatically）并已勾选
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
