【Java】replaceAllで失敗しない

2025年5月15日2025年7月4日

Javaで文字列を置換する際に多くの開発者が使用するreplaceAll()メソッド。しかし、思い通りに動作しない、予期せぬ結果が返ってくるという経験をした方も多いのではないでしょうか？

この記事では、JavaのreplaceAll()を安全に正しく使うための知識と実践テクニックを、よくある失敗例から学びながら解説します。

replaceAllとは？

replaceAll(String regex, String replacement)は、JavaのStringクラスに用意されているメソッドで、正規表現（regex）に一致した部分を、指定の文字列で置換します。

単純な文字列の置換ではなく、正規表現を使って柔軟にマッチングできるのが特徴です。

String input = "abc123def456";
String result = input.replaceAll("[0-9]+", "*");
System.out.println(result); // abc*def*

この例では、[0-9]+という正規表現により、連続する数字がすべてアスタリスクに置き換えられています。

replaceAll()は正規表現ベースのメソッドです。単純な文字列の一致とは異なるため、特殊文字やエスケープに注意が必要です。

よくある失敗パターンと原因

replaceAll()は便利ですが、正規表現特有のルールを理解せずに使うと、思わぬバグや意図しない結果を招きます。実際の失敗例を見ながら、原因を理解しましょう。

1. ドット（`.`）の誤用

正規表現におけるドット.は「任意の1文字」を意味します。これをそのまま使うと、全く意図しない部分が置換されてしまいます。

String input = "a.b";
System.out.println(input.replaceAll(".", "*")); // ***

「ドットをアスタリスクに変えたい」と思っても、すべての文字が対象になります。

2. エスケープ不足による誤動作

ドット.やバックスラッシュ\など、正規表現の特殊文字をそのまま文字として扱いたい場合はエスケープが必要です。正規表現のエスケープ(\)に加えて、Java文字列内でも\が必要なので、\を2個書く必要があります。

String input = "a.b";
System.out.println(input.replaceAll("\\.", "*")); // a*b

これでようやく「ドットという文字」を正しく置き換えることができます。

3. replacement文字列に含まれる特殊記号

replaceAll()の第2引数（replacement）にも注意が必要です。$や\はキャプチャグループの参照やエスケープとして解釈されるため、意図しない動作になることがあります。

String input = "abc123";
System.out.println(input.replaceAll("(\\d+)", "[$1]")); // abc[123]

このように、キャプチャグループを使いたい場合は、正しい書き方を理解することが重要です。$1などは文字列ではなく、正規表現でマッチした値に置き換えられます。

目的別：replaceAllの正しい使い方

replaceAll()は便利ですが、すべての置換に使うべきとは限りません。目的に応じて、replace()や正規表現を適切に使い分けることが重要です。ここでは、代表的な2つのパターンを紹介します。

パターン1：正規表現が不要な単純置換

置換対象が特定の文字列で、正規表現の機能を使う必要がない場合は、replace()メソッドを使うのが安全です。正規表現のルールに左右されず、意図通りの結果が得られます。

String input = "a.b";
System.out.println(input.replace(".", "*")); // a*b

replaceAll()を使うと、.が正規表現として解釈されてしまうため、このような単純置換にはreplace()を使いましょう。

パターン2：最初の1箇所だけを置換したい場合

文字列中の最初の一致だけを置換したい場合は、replaceFirst()を使うのが適しています。replaceAll()と同様に正規表現を使いますが、最初にマッチした1箇所だけが置換される点が特徴です。

String input = "abc123abc456";
String result = input.replaceFirst("[0-9]+", "***");
System.out.println(result); // abc***abc456

replaceAll()との違いを理解し、必要に応じて使い分けることで、意図した置換が可能になります。

パターン3：正規表現で柔軟な置換を行いたい場合

パターンマッチングやキャプチャグループなど、正規表現の強力な機能を活用したい場合はreplaceAll()が適しています。特殊文字のエスケープやグループの参照に注意しながら使いましょう。

String input = "file1.txt file2.txt";
String result = input.replaceAll("file(\\d+)\\.txt", "document$1.md");
System.out.println(result); // document1.md document2.md

この例では、file(\\d+)\\.txtのように正規表現で数値部分をキャプチャし、置換時に$1で参照しています。こうした高度な置換が可能なのはreplaceAll()ならではです。

パターン4：置換後の文字列に特殊文字を含めたい場合

replacement引数に$や\などの特殊記号を文字として含めたい場合、Matcher.quoteReplacement()を使うことで誤解釈を防げます。

String input = "price";
String replacement = Matcher.quoteReplacement("$100");
System.out.println(input.replaceAll("price", replacement)); // $100

quoteReplacement()を使うと、$や\\をエスケープする手間がなく、安全に意図した文字列を使えます。

replaceAll使用時のチェックリスト

replaceAll()は便利な反面、正規表現の知識を前提とするため、少しのミスで想定外の動作につながることがあります。以下のチェックリストで、安全に使えるかを確認しましょう。

✅ 正規表現を使う必要があるか？
単純な文字列置換なら replace() の方が安全で明快です。
✅ 検索文字列に特殊文字を含んでいないか？
.、*、+、?、()、[]、{}、\\、^、$ などの正規表現のメタ文字は、必要に応じて \\ でエスケープが必要です。
✅ replacement文字列に $ や \\ を含んでいないか？
$1 などはキャプチャグループを意味し、\\ は特殊解釈されるため、Matcher.quoteReplacement() を使うか、正しくエスケープしましょう。
✅ 読みやすさと保守性に配慮しているか？
正規表現が複雑な場合は、Pattern.compile() で事前に定義することでコードの見通しがよくなります。