目录
- 第一步:下载和安装 Eclipse
- 下载 Eclipse IDE
- 安装 Eclipse
- 第二步:配置 Java 开发环境
- 验证 JDK 是否已安装
- 在 Eclipse 中配置 JDK
- 第三步:创建和配置 Java 项目
- 创建新 Java 项目
- 配置项目构建路径
- 第四步:编写、运行和调试代码
- 创建 Java 类
- 运行 Java 程序
- 调试 Java 程序
- 第五步:常用插件推荐
提升开发效率的插件
(图片来源网络,侵删) - 第六步:常见问题与解决方案
java.lang.UnsupportedClassVersionErrorThe import XXX cannot be resolved- 中文乱码问题
第一步:下载和安装 Eclipse
下载 Eclipse IDE
Eclipse 是一个开源的集成开发环境,主要基于 Java 开发,您需要从官方网站下载。
- 访问官网:打开浏览器,访问 Eclipse 官方下载页面。
- 选择版本:
- Eclipse IDE for Enterprise Java and Web Developers:这是最推荐的版本,包含了 Java EE、Web、数据库等开发工具,功能最全面。
- Eclipse IDE for Java Developers:如果您只做标准的 Java SE(桌面、控制台)开发,这个版本足够了,体积更小。
- 选择操作系统:根据您的操作系统选择 Windows 64 bit, Mac OS Cocoa, 或 Linux 64 bit。
- 下载:点击 "Download" 按钮,下载的是一个
.zip或.tar.gz压缩包,而不是一个安装程序。
安装 Eclipse
Eclipse 是一个 绿色软件,解压即可使用,无需复杂的安装过程。
- 解压文件:
- Windows: 右键下载的
.zip文件,选择“全部提取”。 - Mac / Linux: 使用解压工具解压
.tar.gz文件。
- Windows: 右键下载的
- 运行 Eclipse:
- 进入解压后的文件夹。
- 找到
eclipse.exe(Windows) 或Eclipse.app(Mac) 文件,双击运行。
- 选择工作空间:
- 第一次启动时,Eclipse 会提示您选择一个“工作空间”(Workspace),这是您存放所有项目和代码的文件夹。
- 您可以创建一个新的文件夹作为工作空间,
D:\JavaProjects。 - 勾选 "Use this as the default and do not ask again" 可以避免每次启动都弹出此窗口。
- 点击 "Launch"。
第二步:配置 Java 开发环境
Eclipse 本身是用 Java 编写的,因此它需要一个 Java Development Kit (JDK) 来运行和编译您的代码。
验证 JDK 是否已安装
在配置 Eclipse 之前,请确保您的电脑上已经安装了 JDK。

- 打开命令行工具:
- Windows: 按
Win + R,输入cmd,回车。 - Mac: 打开“终端”(Terminal)。
- Windows: 按
- 输入以下命令并回车:
java -version
- 如果看到类似
java version "17.0.2"的输出,说明 JDK 已安装,如果提示“不是内部或外部命令...”,则说明 JDK 未安装或未配置环境变量,需要先去 Oracle 官网 下载并安装 JDK。
在 Eclipse 中配置 JDK
这一步至关重要,它告诉 Eclipse 使用哪个 JDK 来编译和运行您的项目。
- 在 Eclipse 菜单栏中,选择 Window -> Preferences。
- 在弹出的窗口中,导航到 Java -> Installed JREs。
- 点击 Add... 按钮。
- 在弹出的窗口中,选择 Standard VM,然后点击 Next。
- 在 JRE home 目录下,点击 Directory...,然后浏览并选择您的 JDK 安装路径(
C:\Program Files\Java\jdk-17)。 - JRE name 会自动填充,您可以保持默认或修改。
- 点击 Finish。
- 返回到 "Installed JREs" 窗口,确保您刚刚添加的 JDK 前面有一个 打勾。
- 点击 Apply and Close。
Eclipse 已经配置好了 JDK。
第三步:创建和配置 Java 项目
创建新 Java 项目
- 在 Eclipse 菜单栏中,选择 File -> New -> Java Project。
- Project name: 输入您的项目名称,
HelloWorld。 - Location: 默认为您的工作空间路径,可以修改。
- JRE: 选择 "Use a project specific JRE",然后从下拉菜单中选择您刚刚配置好的 JDK。
- 勾选 Create module-info.java file (如果您想使用 Java 9+ 的模块系统,可以勾选;对于初学者,可以不勾选)。
- 点击 Finish。
Eclipse 会在左侧的 Package Explorer 视图中创建您的项目结构。
配置项目构建路径
Eclipse 会自动处理好,但如果您需要添加额外的库(JAR 文件),就需要配置构建路径。

- 在 Package Explorer 中,右键点击您的项目(
HelloWorld)。 - 选择 Build Path -> Configure Build Path...。
- 在 Libraries 选项卡中:
- Add External JARs...: 用于添加您本地硬盘上的 JAR 文件。
- Add JARs...: 用于添加项目内的其他 JAR 文件。
- 配置完成后,点击 Apply and Close。
第四步:编写、运行和调试代码
创建 Java 类
- 在 Package Explorer 中,右键点击您的项目下的
src文件夹。 - 选择 New -> Class。
- Package: 输入包名,
com.example.hello,包名有助于组织代码,遵循反向域名命名规范。 - Name: 输入类名,
Main。 - 勾选 public static void main(String[] args),这会自动为您创建程序的入口点。
- 点击 Finish。
Eclipse 会生成一个 .java 文件,并打开编辑器。
package com.example.hello;
public class Main {
public static void main(String[] args) {
// TODO Auto-generated method stub
System.out.println("Hello, Eclipse!");
}
}
运行 Java 程序
有多种方式可以运行代码:
- 方式一(最常用): 在编辑器中,右键点击代码的任意位置,选择 Run As -> Java Application。
- 方式二: 点击编辑器工具栏上的绿色“播放”按钮。
- 方式三: 使用快捷键
Ctrl + F11(Windows/Linux) 或Cmd + F11(Mac)。
程序运行后,结果会显示在 Eclipse 底部的 Console 视图中。
调试 Java 程序
调试是查找和修复错误的关键技能。
- 设置断点:在代码行号前面的灰色区域,双击鼠标,会出现一个蓝色的圆点,这就是断点。
- 启动调试:右键点击代码,选择 Debug As -> Java Application。
- 切换到 Debug 视图:程序会在断点处暂停,Eclipse 会切换到 Debug透视图。
- Variables 视图:显示当前作用域内所有变量的值。
- Debug 视图:显示线程和调用栈。
- 控制按钮:
- Resume (F8): 恢复程序执行,直到下一个断点。
- Step Into (F5): 进入当前行调用的方法内部。
- Step Over (F6): 执行当前行,但不进入方法内部。
- Step Return (F7): 执行完当前方法,并返回到调用处。
- Terminate (Ctrl + F2): 停止调试。
第五步:常用插件推荐
Eclipse 的强大之处在于其可扩展性,以下是一些非常实用的插件:
- Maven Integration for Eclipse (m2e): 现代 Java 项目几乎都使用 Maven 或 Gradle 进行依赖管理,这个插件让您可以直接在 Eclipse 中管理 Maven 项目。
- Eclipse Git Team Provider: 集成 Git 版本控制,让您可以直接在 IDE 中进行代码提交、拉取、合并等操作。
- Checkstyle / PMD / FindBugs: 代码质量检查工具,帮助您编写更规范、更少错误的代码。
- Lombok: 通过注解简化 Java Bean 的编写(如
@Getter,@Setter,@Data),极大减少样板代码。 - Spring Tools (for Spring Boot): 如果您开发 Spring Boot 应用,这个插件是必备的,提供了强大的项目创建、运行和调试支持。
安装方法:Help -> Eclipse Marketplace...,然后搜索并安装。
第六步:常见问题与解决方案
java.lang.UnsupportedClassVersionError
- 问题现象: 运行程序时,控制台报错
UnsupportedClassVersionError。 - 原因: 您编译代码时使用的 JDK 版本高于运行程序时使用的 JRE 版本,用 JDK 17 编译,但运行环境是 JRE 8。
- 解决方案:
- 确保 Eclipse 中配置的 JDK 和运行程序的 JRE 版本一致(参考第二步)。
- 检查项目的 Build Path,确保它指向了正确版本的 JDK。
The import XXX cannot be resolved
- 问题现象: 代码中引入的包或类(如
import java.util.ArrayList;)出现红色下划线,提示无法解析。 - 原因:
- 拼写错误。
- 缺少相应的 JAR 包在项目的构建路径中。
- 项目编码问题导致文件无法正确读取。
- 解决方案:
- 检查拼写。
- 右键项目 -> Build Path -> Configure Build Path -> Libraries,检查并添加所需的 JAR 包。
- 检查文件编码:Window -> Preferences -> General -> Workspace -> Text file encoding,设置为 UTF-8。
中文乱码问题
- 问题现象: 代码中的中文注释或输出的中文字符显示为乱码。
- 原因: 文件编码或控制台编码不一致。
- 解决方案:
- 设置文件编码: 右键项目 -> Properties -> Resource -> Text file encoding,设置为 UTF-8,新建的文件也建议设置为 UTF-8。
- 设置控制台编码: 在 Console 视图标题栏点击右键,选择 Preferences -> Encoding,设置为 UTF-8。
希望这份详细的指南能帮助您顺利配置和使用 Eclipse 进行 Java 开发!祝您编码愉快!
