【面向新人】Java开发中最先确认的Eclipse便捷设置指南

日本語|English|中国语
| 4 min read
Author: toshio-ogiwara toshio-ogiwaraの画像
Information

为了覆盖更广泛的受众,这篇文章已从日语翻译而来。
您可以在这里找到原始版本。

我认为,即使在新员工培训阶段,仍然有很多团队在使用 Eclipse。是否了解一些小设置,会直接影响到日常开发的效率和压力。本文将总结并介绍对 Java 开发有帮助的 Eclipse 基本设置,并将新手阶段应该掌握的要点尽可能精简地整理。通过了解各项设置的位置和含义,一起迈出构建开发环境的第一步吧。

Information

本文以 Pleiades All in One 为前提。Pleiades 已经为许多设置提供了默认值,但默认配置可能会因版本而变化,也可能在不经意间被修改。了解在哪里可以配置哪些选项,对于熟练使用 Eclipse 至关重要。希望你能借此机会,通过本文理解各设置的含义及操作方法。

1. 确认 Java 版本

#

首先确认 Java 项目中使用的 JDK 版本设置。

  • 在「窗口 → 设置 → Java → 已安装的 JRE」中确认要使用的 JDK,并根据需要更改默认值。

jre

这里选中的 JDK(JRE) 将作为新创建的 Java 项目所使用的 JDK。这是默认设置,因此在项目创建后,也可以单独更改要使用的 JDK。

确认使用版本非常重要

Eclipse 刚安装完成或新建工作区后,可能未正确设置要使用的 JDK。即使使用 Pleiades All in One,如果所用 JDK 与 Java 项目预期的版本不一致,也会导致编译错误或构建失败。通过在创建项目之前明确确认“将使用哪个 JDK”,可以提前避免潜在问题。因为这是开发环境的基础部分,所以务必记得检查!

2. 统一字符编码

#

为防止整个项目出现乱码,将字符编码设置为 UTF-8。

  • 在「窗口 → 设置 → 常规 → 工作区」中,将「文本文件编码」设置为 UTF-8。

utf8

选择 UTF-8 作为字符编码的基础

如今,将源代码的字符编码选择为 UTF-8 是基本做法。它能更好地防止在不同操作系统之间或与其他开发者协作时出现乱码,并且大多数工具和库也优先支持 UTF-8。

3. 设置代码格式化

#

为了自动保持整洁的 Java 代码,我们来设置代码格式化。

  • 在「窗口 → 设置 → Java → 代码样式 → 格式化器」中选择喜欢的设置(推荐使用默认的 Pleiades[自定义])。

format

缩进:空格派?制表符派?

Pleiades[自定义] 定义的代码风格基于 Java 广泛使用的通用风格,可在大多数开发项目中无缝使用。但要注意,默认的缩进是“制表符(Tab)”
实际上,也有很多项目使用“空格”进行缩进。因此,建议根据项目或团队的规范,酌情进行修改。顺带一提,笔者偏爱空格,对于除空格缩进外的方式……生理上难以接受。

indent

4. 显示行号

#

为了便于代码审查和错误定位,设置为显示行号,效果如下。

line_no

  • 在「窗口 → 设置 → 常规 → 编辑器 → 文本编辑器」中勾选「显示行号」。

line_no_check

知道行号后提问更方便!

当向前辈咨询错误时,如果你说“在某处出现了错误……”,通常会被反问“那是哪里?第几行?”。在这种时候,能够干脆利落地回答“是第 XX 行”就是成为优秀工程师的第一步。始终显示行号可以说是程序员的基本礼仪。虽然它对界面外观的影响很小,但会直接影响日常交流的顺畅度,是非常重要的设置。

5. 显示每行字符数

#

为了更易阅读和整理代码,显示字符数指南。

guideline

  • 在「窗口 → 设置 → 常规 → 编辑器 → 文本编辑器」中勾选「显示打印边距」,并将右侧边距设置为 120 或其他合适的值。

guideline_check

通过指南了解折行位置

Eclipse 的格式化功能当某行字符数超过设置值时,会自动按照下面这样折行(换行)。

guideline_check

这种自动折行虽然方便,但如果完全交给格式化器来处理,可能会在意想不到的位置断行,导致代码可读性下降。因此,也建议使用指南线来手动在合适的位置进行换行。

6. 调整字体和字号

#

为打造更易阅读且不易疲劳的界面,调整字体和字号。

  • 在「窗口 → 设置 → 常规 → 外观 → 颜色和字体 → 基本 → 文本字体」中,设置喜欢的字体和字号(例如:「Consolas 12」)。

font

推荐编程字体!

Eclipse 默认字体(例如:MS ゴシック)虽然没有问题,但使用专为编程设计的字体会大大提升符号和英数字的可读性,让编程更舒适。虽然需要安装,但非常值得一试。例如,笔者多年来一直爱用 Ricty Diminished(目前已停止维护)。即使外观差异不明显,长时间工作时在疲劳度和误读率上也会有很大差别。请寻找适合自己的字体。以下是 MS ゴシック 和 Ricty Diminished 的对比示例。

font_comp

7. 保存时自动整理导入

#

自动整理不必要的导入,保持代码整洁。

  • 在「窗口 → 设置 → Java → 编辑器 → 保存操作」中勾选「整理导入」。

import_check

启用此功能后,在文件保存时会自动删除未使用的 import 语句、展开通配符(*)导入并进行排序,效果如下。

import

避免使用通配符导入(如 import java.util.*)!

使用通配符(*)来汇总 import 语句可能导致意外的类冲突,也不利于把握实际使用的类。在 Java 开发中,明确导入所使用的类是基本做法。请在 Eclipse 设置中配置“不要使用通配符导入”。

8. 控制台输出设置

#

调整控制台的历史记录和字符限制,使查看日志更方便。

  • 在「窗口 → 设置 → 运行/调试 → 控制台」中调整控制台的输出限制。

console

如果觉得日志被截断或丢失?

Eclipse 控制台显示的日志量有上限。因此,当大量日志一次性输出时,旧日志可能被部分删除。这时,将控制台的缓冲区大小设置大一些就很有效。

9. 保存时自动删除行尾空白

#

自动删除视觉上难以察觉的行尾空白,以减少差异并便于审查。

  • 在「窗口 → 设置 → 常规 → 编辑器 → AnyEdit 工具」中勾选「删除行尾空白」[1]

space

减少差异、便于审查是什么意思?

行尾空白在视觉上难以察觉,但在 Git 等版本控制工具中会被检测为差异。结果,文件中就会包含“实际上无意义的更改”,在审查时可能掩盖本质改动。通过启用自动删除行尾空白的设置,可以消除这种噪音,减轻审查负担并提高历史记录的可读性。虽然只是小小的改动,但在团队开发中却非常有效。

10. 可视化全角空格和换行符

#

为防止意外的全角空格或换行差异造成的问题,使其可视化以便目视确认。

  • 在「窗口 → 设置 → 常规 → 编辑器 → 文本编辑器」中勾选「显示空白字符」,即可显示全角空格、制表符和换行符号。还可以通过“可视性配置”链接打开的对话框对显示对象进行细致调整。

disp

启用此设置后,空格、制表符和换行符号将按以下方式显示。

disp_char

为什么可视化全角空格很重要?

在 Java 中,如果可执行的代码行中混入了全角空格,可能会导致编译错误。尤其是在输入日语时不小心打入的全角空格,外观上很难辨别,容易让人不知道原因而陷入困境。为了防止这类问题,务必启用让全角空格和换行符可见的设置。这样在“为什么报错?”的时候,就不会浪费多余时间来排查了。

结语

#

Eclipse 功能众多,初次使用时可能会迷失在哪些设置项中。但只要掌握了本文介绍的这些基础设置,就能大大提升开发体验。
希望本文能作为你持续使用过程中,找到“适合自己的环境”的第一步,并对你有所帮助!


  1. 在较新的 Eclipse 中,也可以在「窗口 → 设置 → Java → 编辑器 → 保存操作」中启用“附加操作”来删除行尾空白,但这会启用许多其他功能,因此此处仅介绍功能相对简单的 AnyEdit 工具插件的设置示例。 ↩︎

豆蔵では共に高め合う仲間を募集しています!

recruit

具体的な採用情報はこちらからご覧いただけます。