讲师中心 微信公众号
AI工具推荐 视频效率加速

Java新手第一次搭建环境容易踩的坑有哪些

浅伟酱_2553

浅伟酱_2553

发布时间:2026-01-09 16:09:02

|

300人浏览过

|

来源于php中文网

原创

Java版本与JAVA_HOME配置错误导致编译运行失败:需确保JAVA_HOME指向JDK根目录(非bin)、路径无空格/中文;Maven需≥3.6.3且maven-compiler-plugin≥3.8.0;IDE需独立配置JDK路径;多JDK共存时应统一终端实际调用版本。

java新手第一次搭建环境容易踩的坑有哪些

Java版本和JAVA_HOME路径配错最常见

新手常直接下载最新版JDK(比如JDK 21),但IDE或构建工具(如Maven)默认不认高版本,报错Unsupported class file major version。关键是JAVA_HOME必须指向JDK根目录(不是bin子目录),且路径中不能含中文、空格或Program Files这类带空格的文件夹。

  • 验证方式:终端运行 echo $JAVA_HOME(macOS/Linux)或 echo %JAVA_HOME%(Windows),再执行 java -version 和 javac -version,两个输出版本号必须一致
  • Windows用户容易把JAVA_HOME设成C:\Program Files\Java\jdk-17.0.1\bin——错,bin要删掉
  • Mac用户用Homebrew装的OpenJDK,路径通常是/opt/homebrew/opt/openjdk,但这个是符号链接,建议用realpath确认真实路径

Maven找不到tools.jar或提示Could not find artifact

这是JDK 9+彻底移除tools.jar导致的典型兼容问题。如果你用的是老教程或旧版Maven插件(比如maven-compiler-plugin低于3.8.0),它仍尝试加载已不存在的jar,就会失败。

  • 检查pom.xml里maven-compiler-plugin版本:<version>3.11.0</version>以上才安全
  • Maven本身也要≥3.6.3(官网下载页明确标“JDK 11+”支持)
  • 别手动往lib目录塞tools.jar——JDK 17根本没这个文件,硬塞会引发类加载冲突

IDE(IntelliJ / Eclipse)识别不到JDK或编译级别错乱

IDE的JDK配置和系统环境变量是两套独立设置。即使JAVA_HOME正确,IDE也可能用自带的JRE或缓存旧路径。

windows-auto
windows-auto

Windows 桌面自动化技能,支持鼠标控制(移动/点击/拖拽/滚轮/截图)、键盘输入(文字输入/按键/组合键)、窗口管理(查找/聚焦/最大化/最小化/关闭/移动)、截图并发送文件。提供两种截图方式:Python pyautogui 截图(集成在自动化流程中)和 PowerShell + .NET 零依赖截图(支持区域截图和多显示器)。当用户需要自动化 Windows 桌面操作、控制鼠标键盘、管理窗口、执行 GUI 自动化任务、截图发送文件时使用。

下载
  • IntelliJ:File → Project Structure → Project → Project SDK → 点“+”添加JDK,选你本地安装的jdk-17.0.1目录(不是jre)
  • Eclipse:Preferences → Java → Installed JREs → Add → Standard VM → Directory选JDK根目录;再进Project → Properties → Java Build Path → Libraries → 右侧“Edit…”确保用的是刚添加的JDK
  • 项目级编译级别(如Language Level)要和JDK版本匹配:JDK 17对应17 - Sealed types, pattern matching for switch,别选成8或21

运行时NoClassDefFoundError却明明有.class文件

这通常不是缺类,而是类加载器找不到依赖——尤其新手把javac和java命令混用时路径没对齐。

立即学习“Java免费学习笔记(深入)”;

  • javac Hello.java生成Hello.class后,必须在Hello.class所在目录执行java Hello(不能加.class后缀)
  • 如果类在包里(如package com.example;),源文件必须放在com/example/Hello.java路径下,编译后进入com/example/上一级目录,再用java com.example.Hello
  • 用-cp指定类路径时,当前目录要用.表示:java -cp ".:lib/some.jar" Main(macOS/Linux)或java -cp ".;lib\some.jar" Main(Windows)

最麻烦的其实是多个JDK共存时的隐性冲突——比如Android Studio自带JDK、VS Code Java插件自配JDK、系统又装了一个,三者版本和JAVA_HOME不同步,错误信息却只报“无法启动”。遇到这种,先关掉所有IDE,只用终端跑java -version和which java(macOS/Linux)或where java(Windows),盯住到底调用的是哪个java可执行文件。

热门AI工具

更多
Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

创客贴AI

创客贴AI是一款AI图像与设计工具,AI辅助的智能在线设计工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

花生AI
花生AI Hot

一款AI视频创作工具,主要用于B站推出的AI视频创作工具,适合需要提升相关任务效率的用户。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

相关专题

更多
eclipse教程
eclipse教程

php中文网为大家带来eclipse教程合集,eclipse是一个开放源代码的、基于Java的可扩展开发平台。就其本身而言,它只是一个框架和一组服务,用于通过插件组件构建开发环境。php中文网还为大家带来eclipse的相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

690

2023.06.14

eclipse怎么设置中文
eclipse怎么设置中文

eclipse设置中文的方法:除了设置界面为中文外,你还可以为Eclipse添加中文插件,以便更好地支持中文编程。例如,你可以安装EBNF插件来支持中文变量名,或安装Chinese Helper来提供中文帮助文档。本专题为大家提供eclipse设置中文相关的各种文章、以及下载和课程。

5946

2023.07.24

c语言编程软件有哪些
c语言编程软件有哪些

c语言编程软件有GCC、Clang、Microsoft Visual Studio、Eclipse、NetBeans、Dev-C++、Code::Blocks、KDevelop、Sublime Text和Atom。更多关于c语言编程软件的问题详情请看本专题的文章。php中文网欢迎大家前来学习。

9219

2023.11.02

Eclipse版本号有哪些区别
Eclipse版本号有哪些区别

区别:1、Eclipse 3.x系列:Eclipse的早期版本,包括3.0、3.1、3.2等;2、Eclipse 4.x系列:Eclipse的最新版本,包括4.0、4.1、4.2等;3、Eclipse IDE for Java Developers等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2804

2024.02.23

eclipse和idea有什么区别
eclipse和idea有什么区别

eclipse和idea的区别:1、平台支持;2、内存占用;3、插件系统;4、智能代码提示;5、界面设计;6、调试功能;7、学习曲线。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

662

2024.02.23

eclipse设置中文全教程
eclipse设置中文全教程

本专题整合了eclipse设置中文相关教程,阅读专题下面的文章了解更多详细操作。

3826

2025.10.10

eclipse字体放大教程
eclipse字体放大教程

本专题整合了eclipse字体放大教程,阅读专题下面的文章了解更多详细内容。

3845

2025.10.10

eclipse左边栏不见了解决方法
eclipse左边栏不见了解决方法

本专题整合了eclipse左边栏相关教程,阅读专题下面的文章了解更多详细内容。

528

2025.10.15

Uvicorn 报错与问题解决教程
Uvicorn 报错与问题解决教程

本专题汇总了Uvicorn服务器常见问题与报错解决的教程合集,涵盖启动失败、端口占用、模块导入错误、事件循环冲突及热重载失效等典型故障的排查思路。同时整理了多进程与Worker配置、SSL/HTTPS证书报错、跨域与代理配置等实战解决方案,助你快速定位并解决Uvicorn运行中的各类问题。

0

2026.11.02

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Python uv官方安装与入门文档
Python uv官方安装与入门文档

共0课时 | 0人学习

Buffalo框架快速入门指南
Buffalo框架快速入门指南

共0课时 | 0人学习

Valgrind支持平台说明
Valgrind支持平台说明

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn