新建项目时选错jdk版本会导致编译失败,需正确配置jdk 17/21、统一utf-8编码、开启自动构建并手动触发编译,三者缺一不可。

创建新项目时选错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 启动参数、终端编码、源文件编码三者不一致。
Java Maven 项目审查工作流的通用输入处理。当 Java Maven 项目以 ZIP压缩包或 GitLab 仓库 URL 形式提供且需要...时使用。
实操建议:
- 统一设为 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”卡在输出之前。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










