根本原因是未正确安装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，命令行调用了不同来源的程序。
- 运行
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，靠自己配置的路径加载。
立即学习“Java免费学习笔记（深入）”；
- 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等），易漏
