如何在 Java 中正确将 Unicode 艺术（如 8 点盲文）写入文件

在使用 Ja va 的 FileWriter 写入 Unicode 字符时，一个常见又让人头疼的问题是：控制台输出完全正常，但写的文件却是空的。这种情况在生成 Braille 符号（比如 ⣿、⢆）这类 Unicode 艺术时尤其容易遇到。不用怀疑，你的逻辑没问题，问题出在 FileWriter 的缓冲机制上。

先说结论：控制台能正常显示，说明 JVM 和字符编码环节都没问题。那文件为什么是空的？核心原因已经浮出水面——FileWriter 内部使用了缓冲区来提升 I/O 性能。换句话说，writer.write(...) 只是把数据写到了内存缓冲区里，并没有真正落盘。如果不调用 flush() 强制刷新，或者不调用 close() 自动触发 flush，那么程序结束时，这些滞留在缓冲区里的数据就会被直接丢弃。结果就是：文件内容为空。

正确的做法其实很简单：在完成写入后，必须显式关闭流，或者先 flush 再 close。推荐使用 try-with-resources 语法，既安全又简洁：

// ✅ 推荐：try-with-resources 自动关闭，可靠无忧
try (FileWriter writer = new FileWriter(homeAdress + "output.txt", false)) {
    for (int i = 0; i < outputChar.length; i++) {
        for (int j = 0; j < outputChar[i].length; j++) {
            writer.write(outputChar[i][j]);
        }
        writer.write('\n');
    }
    // 不需要手动 flush() —— close() 在 try 块结束时自动执行 flush + 关闭
} catch (IOException e) {
    e.printStackTrace();
    System.err.println("FAILED to write file");
}

⚠️ 值得注意的几个细节：

• 不要只 flush 却不 close。虽然 flush 能临时解决数据不落盘的问题，但如果程序不关闭流，文件句柄就一直被占用。对于长期运行的程序或者频繁写文件的循环，很容易出现 Too many open files 异常。
• 编码问题同样关键。FileWriter 默认使用平台编码（Windows 上通常是 GBK），而 Braille 字符位于 U+2800–U+28FF 范围内，很多编辑器或终端只有用 UTF-8 才能正确渲染。如果需要跨平台兼容，建议换用 OutputStreamWriter 并显式指定编码：

  try (FileOutputStream fos = new FileOutputStream(homeAdress + "output.txt");
       OutputStreamWriter writer = new OutputStreamWriter(fos, StandardCharsets.UTF_8)) {
      // 写入逻辑同上
  }

• Braille 映射逻辑需要验证。你代码中 TurnTo8DotsBraille 里出现类似 out = out + 1000 的写法，这实际上是在做十进制数值累加，不是位运算。正确的做法是使用位掩码操作，将 8 个像素点映射到 Braille 字符的对应位：

  public static char TurnTo8DotsBraille(int[][] subPixle) {
      int dots = 0;
      if (subPixle[0][0] == 1) dots |= 1 << 0;   // 第1点（上左）
      if (subPixle[1][0] == 1) dots |= 1 << 1;   // 第2点（中左）
      if (subPixle[2][0] == 1) dots |= 1 << 2;   // 第3点（下左）
      if (subPixle[3][0] == 1) dots |= 1 << 3;   // 第4点（底左）
      if (subPixle[0][1] == 1) dots |= 1 << 4;   // 第5点（上右）
      if (subPixle[1][1] == 1) dots |= 1 << 5;   // 第6点（中右）
      if (subPixle[2][1] == 1) dots |= 1 << 6;   // 第7点（下右）
      if (subPixle[3][1] == 1) dots |= 1 << 7;   // 第8点（底右）
      return (char) (0x2800 + dots); // Unicode Braille Patterns 起始于 U+2800
  }

说到底，这个“控制台正常、文件为空”的问题，核心就一条：确保 I/O 流被正确关闭。用好 try-with-resources 可以一劳永逸地避免这类陷阱。同时别忘了检查 Unicode 映射逻辑和文件编码，这样才能真正生成可读、可复用的 Braille 文本输出。