核心概念：什么是编码？

编码是字符（如 'A', '中', '€'）与二进制数据（0和1序列）之间的一套转换规则。

• 字符集：定义了有哪些字符，ASCII 定义了 128 个英文字符，GBK 定义了中文字符和 ASCII 字符，而 Unicode 则旨在收录世界上所有的字符。
• 编码方案：将字符集中的字符编码成二进制的具体方法，UTF-8 是 Unicode 最常用的一种编码方案，它使用 1 到 4 个字节来表示一个字符。

Java 内部使用 Unicode (UTF-16) 来处理所有字符，这意味着在程序运行时，内存中的字符串对象都是统一的 Unicode，编码问题主要发生在内存与外部世界交互时，

• 读取源代码文件 (.java)
• 读取/写入文本文件 (.txt, .json, .xml)
• 从数据库读取/写入数据
• 通过 HTTP 请求/响应收发数据

如果这些环节的编码设置不一致,就会出现乱码。

设置 Eclipse 工作空间的编码

这是最基础也是最重要的一步,它决定了 Eclipse 默认处理所有文件（包括新创建的 .java 文件）的编码。

操作步骤：

1. 打开 Eclipse，点击菜单栏的 Window -> Preferences (在 macOS 上是 Eclipse -> Preferences)。
2. 在弹出的窗口中,导航到 General -> Workspace。
3. 在右侧找到 Text file encoding 选项。
4. 强烈建议选择 Other，然后在下拉菜单中选择 UTF-8。
5. 点击 Apply and Close。

为什么必须是 UTF-8？ UTF-8 是目前国际通用的标准编码，它能完美兼容英文、中文、日文等几乎所有语言，是跨平台协作的最佳选择。

设置项目特定的编码

你可能需要为一个特定的项目设置不同的编码（维护一个旧项目，它要求使用 GBK），这时，可以为单个项目覆盖工作空间的默认设置。

操作步骤：

1. 在 Package Explorer 或 Project Explorer 视图中，右键点击你的项目。
2. 选择 Properties。
3. 在弹出的窗口中,导航到 Resource。
4. 在右侧找到 Text file encoding 选项。
5. 选择 Other，然后选择你需要的编码（如 GBK）。
6. 点击 Apply and Close。

注意： 如果项目设置了编码，它会覆盖工作空间的编码设置，这可能会导致项目中部分文件是 UTF-8，部分是 GBK，增加复杂性。除非有特殊原因，否则应尽量保持整个工作空间使用统一的 UTF-8 编码。

设置源代码文件 (.java) 的编码

在 Eclipse 中，当你创建一个新的 .java 文件时，它会使用工作空间或项目的编码，但如果你打开一个外部引入的 .java 文件，Eclipse 可能会错误地识别其编码。

检查和修改单个文件的编码：

1. 在编辑器中打开一个 .java 文件。
2. 右键点击编辑器的空白区域,选择 Text File Encoding。
3. 你会看到三个选项：
   • Default (UTF-8): 使用工作空间或项目的默认编码。
   • Other: 可以手动为这个文件指定一个不同的编码。
   • Always convert to ...: 非常有用！ 它会读取文件内容，尝试识别其原始编码，然后将其转换并保存为你选择的编码（通常是 UTF-8），如果你看到一个文件是乱码，使用这个功能可以一键修复。

如何确保新文件永远是 UTF-8？ 只要你的工作空间编码设置为 UTF-8，新创建的文件自然就是 UTF-8。

在代码中处理 I/O（读写文件）

即使你的 IDE 和源文件都是 UTF-8，如果你在代码中读写文件时没有指定编码，依然会使用系统的默认编码（在中文 Windows 上通常是 GBK），从而导致乱码。

正确做法： 在所有涉及 I/O 的地方，显式地指定编码为 "UTF-8"。

读取文件 (错误 vs. 正确)

错误示范 (依赖系统默认编码):

// 可能会乱码，如果文件是UTF-8但系统默认是GBK
try (BufferedReader reader = new BufferedReader(new FileReader("mydata.txt"))) {
    String line;
    while ((line = reader.readLine()) != null) {
        System.out.println(line);
    }
} catch (IOException e) {
    e.printStackTrace();
}

正确示范 (显式指定 UTF-8):

// 正确，显式指定了UTF-8编码
try (BufferedReader reader = new BufferedReader(new InputStreamReader(new FileInputStream("mydata.txt"), "UTF-8"))) {
    String line;
    while ((line = reader.readLine()) != null) {
        System.out.println(line);
    }
} catch (IOException e) {
    e.printStackTrace();
}

• FileInputStream: 获取原始字节流。
• InputStreamReader: 将字节流解码为字符流，构造时指定编码。
• BufferedReader: 提供高效的按行读取功能。

写入文件 (错误 vs. 正确)

错误示范 (依赖系统默认编码):

// 可能会乱码
try (BufferedWriter writer = new BufferedWriter(new FileWriter("output.txt"))) {
    writer.write("你好，世界！");
} catch (IOException e) {
    e.printStackTrace();
}

正确示范 (显式指定 UTF-8):

// 正确，显式指定了UTF-8编码
try (BufferedWriter writer = new BufferedWriter(new OutputStreamWriter(new FileOutputStream("output.txt"), "UTF-8"))) {
    writer.write("你好，世界！");
} catch (IOException e) {
    e.printStackTrace();
}

• FileOutputStream: 获取原始字节流。
• OutputStreamWriter: 将字符流编码为字节流，构造时指定编码。
• BufferedWriter: 提供高效的缓冲写入功能。

处理网络请求 (如 HTTP)

如果你在 Java 程序中通过 HTTP 请求获取数据，也需要处理编码。

使用 HttpClient (Java 11+) 示例：

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.nio.charset.StandardCharsets;
public class HttpRequestExample {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create("https://example.com/api/data"))
                .build();
        // 关键：在响应体的 BodyHandlers 中指定编码
        HttpResponse<String> response = client.send(request, 
            HttpResponse.BodyHandlers.ofString(StandardCharsets.UTF_8));
        System.out.println(response.body());
    }
}

这里,HttpResponse.BodyHandlers.ofString(StandardCharsets.UTF_8) 确保了从网络流中读取的数据被正确地解码为 UTF-8 字符串。

总结与最佳实践

1. 统一为 UTF-8：将整个 Eclipse 工作空间的默认编码设置为 UTF-8，这是最简单、最可靠的做法。
2. 项目编码：除非维护旧项目，否则不要为单个项目设置不同的编码。
3. IDE 内编码：使用 Text File Encoding -> Always convert to ... 功能来修复乱码的源文件。
4. 代码中显式指定：在所有文件读写、网络请求等 I/O 操作中，永远不要依赖系统默认编码，显式地传入 StandardCharsets.UTF_8 或 "UTF-8" 字符串。
   • InputStreamReader(..., StandardCharsets.UTF_8)
   • OutputStreamWriter(..., StandardCharsets.UTF_8)
   • StandardCharsets.UTF_8 是 Java 提供的常量，比硬编码字符串 "UTF-8" 更安全、高效。
5. 数据库连接：在数据库连接字符串中也要指定编码，MySQL 的 useUnicode=true&characterEncoding=UTF-8。

遵循以上步骤,你就可以在 Eclipse 中彻底告别 99% 的编码问题，让 Java 开发过程更加顺畅。