解决java报错：“错误：编码GBK 的不可映射字符”

本文探讨了如何解决 Java 编码过程中常见的“编码GBK 的不可映射字符”错误。主要方法包括：修改源代码文件的编码以匹配编译器，使用 javac -encoding 选项指定编译器编码，通过 IDE 配置确保文件编码一致，以及在代码中使用 Unicode 转义字符。针对使用构建工具的开发环境，还可在 Maven 和 Gradle 配置文件中指定编码。在确保文件、编译器、开发环境编码一致的情况下，可以有效避免字符集不匹配问题，从而解决编码错误。通过这些方法，开发者可以更顺畅地处理多语言字符和特殊字符。

---

🧑 博主简介：
现任阿里巴巴嵌入式技术专家，15年工作经验，深耕嵌入式+人工智能领域，精通嵌入式领域开发、技术管理、简历招聘面试。CSDN优质创作者，提供产品测评、学习辅导、简历面试辅导、毕设辅导、项目开发、C/C++/Java/Python/Linux/AI等方面的服务，如有需要请站内私信或者联系任意文章底部的的VX名片（ID：gylzbk）

💬 博主粉丝群介绍：① 群内初中生、高中生、本科生、研究生、博士生遍布，可互相学习，交流困惑。② 热榜top10的常客也在群里，也有数不清的万粉大佬，可以交流写作技巧，上榜经验，涨粉秘籍。③ 群内也有职场精英，大厂大佬，可交流技术、面试、找工作的经验。④ 进群免费赠送写作秘籍一份，助你由写作小白晋升为创作大佬。⑤ 进群赠送CSDN评论防封脚本，送真活跃粉丝，助你提升文章热度。有兴趣的加文末联系方式，备注自己的CSDN昵称，拉你进群，互相学习共同进步。

背景知识

在编程时，字符编码格式决定了如何将字符转换为字节以及从字节还原为字符。Java 源文件默认使用系统默认编码。对于中文 Windows 系统来说，默认编码通常是 GBK。但是如果源文件包含了 UTF-8 编码的特殊字符或者其他语言的字符（例如中文字符,拉丁文特殊符号等），使用默认的 GBK 编码会导致编译器无法正确识别这些字符，从而出现错误。

错误代码示例

假设我们有一个名为 HelloWorld.java 的文件，其中包含一些 UTF-8 编码的字符（例如中文字符、特殊符号等）：

public class HelloWorld {
    public static void main(String[] args) {
        System.out.println("Hello, 世界!"); // 这里的“世界”是 UTF-8 编码的中文字符
    }
}

报错示范

当使用默认编码 GBK 编译上述文件时，可能会出现如下编译错误：

javac HelloWorld.java
HelloWorld.java:3: 错误：编码GBK的不可映射字符
        System.out.println("Hello, 世界!");
                                   ^
1 个错误

这种情况通常发生在 Windows 操作系统上，因为默认情况下操作系统使用 GBK 编码。

解决方法

你可以通过以下几种方法解决这个问题：

方法1: 使用 -encoding 选项来指定编码格式

你可以在编译时通过 -encoding 选项指定源文件的编码格式。例如，如果源文件是 UTF-8 编码的，可以使用以下命令来编译：

javac -encoding UTF-8 HelloWorld.java

步骤演示:

1. 打开命令提示符（或终端）。
2. 导航到包含 HelloWorld.java 文件的目录。
3. 输入以下命令并回车：

   javac -encoding UTF-8 HelloWorld.java
   

这样，Java 编译器会使用 UTF-8 编码来读取源文件，从而避免编码不匹配的问题。

方法2: 将源文件保存为 GBK 编码

你也可以使用文本编辑器（例如 Notepad++、VS Code 等）将文件保存为 GBK 编码。

步骤演示:

1. 打开文本编辑器。
2. 打开 HelloWorld.java 文件。
3. 选择 “另存为” 选项。
4. 在保存对话框中，选择 GBK 编码格式进行保存。

注意：这种方法要求你确保文件中不包含超出 GBK 编码范围的字符。

方法3: 设置 IDE 编码

如果你使用的是 IDE（例如 IntelliJ IDEA、Eclipse 等），可以在 IDE 中设置源文件的编码格式为 UTF-8。具体操作如下：

IntelliJ IDEA:

1. 打开项目。
2. 选择 File -> Settings -> Editor -> File Encodings。
3. 将 Project Encoding 和 Default Encoding for Properties Files 设置为 UTF-8。
4. 点击 Apply 然后点击 OK。

Eclipse:

1. 打开项目。
2. 选择 Window -> Preferences -> General -> Workspace。
3. 将 Text file encoding 设置为 UTF-8。
4. 点击 Apply 然后点击 OK。

此外，你还可以为特定项目单独设置编码：

1. 右键单击项目，选择 Properties。
2. 选择 Resource。
3. 在 Text file encoding 选项下选择 UTF-8。
4. 点击 Apply 然后点击 OK。

通过上述任一方法，你都可以避免 “错误：编码GBK 的不可映射字符” 问题。调整编码格式为 UTF-8 是一种较为通用且推荐的解决方法，因为 UTF-8 可以覆盖大部分字符集，并且互通性良好。