IDE编译Java代码无法识别特殊字符输出方块，尝试多种方案无效如何解决？

问题表现 #

编译运行Java代码时出现两类稳定复现的异常：

• String类型变量无法被正确读取、解析
• 程序输出的特殊字符全部显示为方块乱码

使用如下最简示例代码复现问题：

public class Main {
    public static void main(String[] args) {
        Scanner sc = new Scanner(System.in);
        System.out.println("Name:");
        String name = sc.nextLine();
        System.out.println(name);
    }   
}

实际运行时，用户输入的带特殊字符的内容无法正常回显，全部显示为方块乱码；在JDBC开发场景下，PreparedStatement对象无法正确识别String类型参数中的特殊字符，导致SQL执行异常。

已完成的排查操作 #

• 定位NetBeans安装目录下的netbeans.conf配置文件，修改相关参数尝试调整
• 安装多个版本的NetBeans IDE开展交叉测试，确认该问题在所有版本中稳定复现，且已穷尽程序提供的所有可配置选项
• 卸载重装对应版本的JDK，为彻底排查问题额外安装JRE做验证，确认重装完成后上述简单示例代码的编译运行问题依然存在

实际影响 #

• 无法开发基于MySQL+JDBC的Java数据库应用，特殊字符参数识别失败会直接导致数据写入、查询逻辑异常
• 无法正常开发通用Java应用，ç、á、ã、â、í等带特殊符号的字符在程序输出端全部显示为方块乱码

根因与解决方案 #

该问题属于典型的全链路字符编码不匹配问题，之前的排查遗漏了多环节的编码一致性配置，按以下步骤调整即可完全解决，无需联系专业技术人员：

• 统一NetBeans IDE的启动编码：在netbeans.conf的netbeans_default_options配置项末尾追加-J-Dfile.encoding=UTF-8，确保IDE本身的运行编码为UTF-8
• 统一项目的编译编码：在NetBeans的项目属性设置中，把源代码编码调整为UTF-8，和本地源码文件的实际保存编码保持一致；在项目运行的VM选项中追加-Dfile.encoding=UTF-8
• 统一控制台的输入输出编码：Windows环境下先执行chcp 65001把控制台默认编码切换为UTF-8，同时修正示例代码中Scanner的初始化逻辑，手动指定和控制台一致的UTF-8编码读取输入：

  // 修正后的Scanner初始化代码
  Scanner sc = new Scanner(System.in, StandardCharsets.UTF_8);
  

• 统一JDBC链路的编码配置：MySQL连接串追加useUnicode=true&characterEncoding=utf8参数，确保应用层、数据库连接、目标表结构的编码完全匹配

内容的提问来源于stack exchange，提问作者pe.Math