根本原因是未正确安装jdk或环境变量配置错误：必须安装含javac的jdk而非仅jre，java_home需指向jdk根目录，path须包含%java_home%\bin，且修改后需重启命令行验证javac -version。

Java初学者在安装和配置环境时，最常卡在“明明装了却用不了”这一步。核心问题不是JDK没下载，而是路径、变量、版本三者没对齐。下面直击高频痛点，不绕弯子。

javac / java 命令提示“不是内部或外部命令”

这是90%新手遇到的第一个拦路虎，本质是系统找不到Java的可执行文件。

• 确认装的是JDK（带javac.exe），不是只有JRE（只有java.exe）——去安装目录看有没有bin\javac.exe
• JAVA_HOME必须设对：值为JDK根目录（如C:\Java\jdk-17），不能指向bin子目录，也不能含中文或空格
• PATH里要包含%JAVA_HOME%\bin（Windows）或$JAVA_HOME/bin（macOS/Linux）；注意Win10/11中Path编辑器支持“新建”行，别手输错分号
• 改完环境变量后，必须关掉所有命令行窗口，重新打开cmd/PowerShell再测试

java -version 和 javac -version 显示不同版本

说明系统里有多个JDK，命令行调用了不同来源的程序。

Java Maven Code Review

审查Java Maven项目（ZIP压缩包或GitLab仓库URL），检查代码规范、命名、模块边界、可维护性问题以及重复代码。

下载

• 运行where java（Windows）或which java（macOS/Linux）查看实际调用路径
• 检查JAVA_HOME是否指向你希望默认使用的JDK（比如想用JDK 17，就别指向JDK 8的文件夹）
• IDE（如IntelliJ IDEA、Eclipse）需单独设置项目SDK——别只依赖系统环境变量，它们有自己的JDK选择逻辑
• 如果用Maven/Gradle，还要核对pom.xml或build.gradle里的java.version是否与本地一致

IDE报错“找不到JDK”或启动失败

命令行能用 ≠ IDE能识别，因为IDE通常绕过系统PATH，靠自己配置的路径加载。

• IntelliJ IDEA：File → Project Structure → Project → Project SDK → 点“+”添加JDK，选jdk-xx根目录（不是bin）
• Eclipse：Window → Preferences → Java → Installed JREs → Add → Standard VM → Directory选JDK根目录
• 若IDE启动直接报“JRE/JDK not available”，可能是版本太新（如JDK 24）与旧版IDE不兼容，建议回退到JDK 17或JDK 21长期支持版
• 某些老工具（如旧版Ant脚本、Eclipse插件）对JDK 17+模块化敏感，可临时在IDE运行配置里加--add-modules=ALL-SYSTEM

中文路径或空格导致编译/运行异常

看似小问题，实则高频隐形杀手，尤其影响批处理、Maven插件、Tomcat启动脚本。

• JDK安装路径务必纯英文、无空格、无括号（推荐：C:\Java\jdk-17 或 /opt/java/jdk-17）
• 项目代码不要放在“桌面”“文档”等含用户中文名的路径下（如C:\Users\张三\Desktop\hello）
• 如果已装在中文路径，重装是最稳妥方案；强行修复需手动修改所有引用该路径的配置（.idea、.settings、pom.xml、tomcat/conf/server.xml等），易漏

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南