IntelliJIDEA快速创建Java项目教程

本文手把手教你避开 IntelliJ IDEA 创建和运行 Java 项目的三大致命坑点：JDK 配置错误导致基础类无法识别、运行配置不当引发入口方法找不到、编码不统一造成中文乱码或编译失败——从正确安装并指定 JDK 17/21、一键生成可靠 Run Configuration，到彻底解决控制台中文问号问题，再到确保代码修改实时生效，每一步都直击新手最常踩的“Hello World 都跑不通”痛点，帮你把环境配置从玄学变成确定性操作。

创建新项目时选错JDK版本会导致编译失败

IntelliJ IDEA 新建项目默认可能用的是 bundled JRE 或未配置的 JDK，javac 不可用或版本不匹配，直接导致 Cannot resolve symbol 'String' 这类基础报错。

实操建议：

• 新建项目前，先确认系统已安装 JDK（非 JRE），推荐 JDK 17 或 JDK 21（LTS 版本）
• 在 New Project 窗口左下角点击 Project SDK → Add JDK... → 选择本地 jdk-17.0.x 或 jdk-21.x 根目录（不是 bin 子目录）
• 勾选 Download JDK 虽方便，但下载源不稳定，容易卡住或选错架构（如 Apple Silicon 机器下误选 x86）
• 创建后立刻检查 File → Project Structure → Project 中的 Project SDK 和 Project language level 是否一致（例如都设为 17）

运行 Main 方法前必须正确配置 Run Configuration

点绿色三角形直接运行失败？大概率是 IDEA 没识别到入口方法，或用了错误的模块/类路径。

实操建议：

• 确保主类含标准签名：public static void main(String[] args)，且类名与文件名完全一致（大小写敏感）
• 右键编辑器中的 main 方法 → 选择 Run 'ClassName.main()'，IDEA 会自动生成配置；不要直接点顶部工具栏的 ▶️（它可能复用旧配置）
• 若提示 Class not found: xxx，检查 Edit Configurations → Use classpath of module 是否指向了当前模块（而非空或错误模块）
• 避免手动修改 Main class 字段——粘贴全限定名（如 com.example.HelloWorld）时多一个空格或少一个点都会失败

控制台中文乱码本质是编码未对齐

运行输出 System.out.println("你好") 显示问号或方块？这不是字体问题，而是 IDEA 启动参数、终端编码、源文件编码三者不一致。

实操建议：

• 统一设为 UTF-8：进入 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 生效）
• Windows 用户还需检查终端：在 Settings → Tools → Terminal 中，Shell path 若是 cmd.exe，需额外加启动参数 /k chcp 65001 >nul
• 验证方式：新建 Java 文件，输入中文并保存，再看右下角状态栏是否显示 UTF-8 —— 若显示 GBK 或空白，说明文件本身没生效

第一次运行后改代码不生效？别急着重启

修改 main 方法内容后点运行，控制台还是旧输出——常见于热替换未触发或构建过程被跳过。

实操建议：

• 确认 Build project automatically 已开启：Settings → Build → Compiler → Build project automatically
• 检查 Settings → Build → Compiler → Configure on build 是否勾选了 Configure on build（部分版本默认关闭）
• 更可靠的做法：修改后按 Ctrl + F9（Windows/Linux）或 Cmd + F9（macOS）手动构建，再运行；观察底部 Build 工具窗口是否有 Build completed successfully
• 如果用了 Maven，注意 pom.xml 中的 sourceEncoding 也要设为 UTF-8，否则 mvn compile 阶段仍会丢字符

JDK 路径、编码、构建触发这三点串起来才是真实的第一步。漏掉任意一个，都会让“Hello World”卡在输出之前。

好了，本文到此结束，带大家了解了《IntelliJIDEA快速创建Java项目教程》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！