【Java】文字化けを防ぐ方法

2025年5月17日

Javaで開発していると、文字化けや環境による動作の違いに悩まされたことはありませんか？
特に、Windowsでは正常に動くのに、Linuxにデプロイしたら文字が崩れる──そんな経験をお持ちの方は多いはずです。

その原因の多くは、「デフォルトのシステムエンコーディングに依存している」ことにあります。この記事では、文字化けが発生する背景とその回避方法、ベストプラクティスまでを詳しく解説します。

なぜ文字化けが起きるのか？

Javaには「デフォルトの文字エンコーディング（文字コード）」という概念があります。これは、JVMが実行されているOSのロケールや設定に依存して決定されるもので、明示的に指定しない限りJavaはこれを使います。

✅ 例：実行環境による違い

実行環境	デフォルトエンコーディング
Windows（日本語版）	MS932（Shift_JIS系）
macOS/Linux（UTF-8環境）	UTF-8

そのため、例えば FileReader や PrintWriter といった文字コードを指定できないAPIを使っていると、環境ごとに異なる文字コードで読み書きされてしまい、結果的に文字化けやデータ破損が発生します。

依存してはいけないNGコード例

以下のようなコードは、デフォルトのエンコーディングに依存してしまうため、移植性に欠けます。

BufferedReader reader = new BufferedReader(new FileReader("data.txt"));
PrintWriter writer = new PrintWriter("output.txt");
String text = new String(byteArray);

これらは一見動作しているように見えても、環境が変わると途端に問題を引き起こす要因となります。

安定した方法：エンコーディングを明示的に指定する

文字化けや移植性の問題を防ぐためには、エンコーディングを明示的に指定することが重要です。
Javaでは、StandardCharsets.UTF_8 などの定数を使って、安全かつ簡潔に指定できます。

✅ 正しいコード例（UTF-8を明示）

BufferedReader reader = new BufferedReader(
    new InputStreamReader(new FileInputStream("data.txt"), StandardCharsets.UTF_8)
);

BufferedWriter writer = new BufferedWriter(
    new OutputStreamWriter(new FileOutputStream("output.txt"), StandardCharsets.UTF_8)
);

String text = new String(byteArray, StandardCharsets.UTF_8);

なぜ `StandardCharsets.UTF_8` を使うべきか？

Charset.forName("UTF-8") より安全（nullやスペルミスのリスクがない）
StandardCharsets はJava標準（Java 7以降）で提供されており、パフォーマンスも良好
UTF-8は世界中の言語に対応しており、国際化・多言語対応に最適

ベストプラクティスと注意点

以下のようなガイドラインを守ることで、文字化けリスクを大幅に減らすことができます。

項目	推奨内容
ファイル読み書き	`InputStreamReader` / `OutputStreamWriter` + `StandardCharsets.UTF_8`
バイト⇔文字変換	`new String(byte[], Charset)` や `String.getBytes(Charset)`
エンコーディングの指定	`StandardCharsets.UTF_8` を常に明示
外部ファイルの処理	入出力形式（文字コード）を仕様として文書化しておく