Javaの改行コードを完全解説｜LF/CRLFの違い・OS依存対策・安全な出力方法まとめ

Javaにおける「改行」は単なる見た目の区切りではなく、可読性・デバッグ効率・ファイル互換性に直結する重要な要素です。しかし、改行コードの違いを意識せず開発していると、OSごとに表示が崩れたり、Gitの差分が膨れ上がったりと思わぬトラブルを招きます。

さらに、JavaではnやSystem.lineSeparator()など複数の扱い方があり、コンソール出力・ファイル出力・複数行文字列リテラルでベストプラクティスも異なります。そのため本記事では、歴史的背景→Javaの基本メソッド→OS依存を避ける方法→ありがちなトラブルと対策という流れで、改行を体系的に整理していきます。

Javaで使われる改行コードの種類と歴史的背景

まず、Javaで扱う改行コードの「種類」と「歴史」を押さえておくと、なぜ環境によって挙動が変わるのかを理解しやすくなります。

「LF」「CRLF」「CR」の違いとOSごとの採用状況

改行コードそのものはJava固有の概念ではなく、OSや古い端末装置の仕様に由来しています。主に以下の3種類があります。

• LF（Line Feed）：行送りのみを行う制御コード（ASCIIコード 10）。現在のUnix / Linux / macOSで標準的に利用されています。
• CRLF（Carriage Return + Line Feed）：行頭復帰＋行送りの2文字セット（ASCIIコード 13+10）。Windows標準の改行コードです。
• CR（Carriage Return）：行頭復帰のみを行う制御コード（ASCIIコード 13）。旧Mac OSで使用されていた形式です。

一方で、これらの違いはテキストファイルをバイナリで見たときの1文字ごとのコードにも表れます。例えばnはASCIIコード10、rは13として扱われ、ツールやライブラリがそれぞれをどう解釈するかで挙動が変わります。

改行コードがソースコードとテキスト処理に与える影響

しかし、改行コードの違いは「見た目」だけの問題にとどまりません。主に以下のような実務上の問題を引き起こします。

• 異なるOS間でファイルを共有すると、エディタによっては改行が正しく表示されない（文字化けのように見える）
• Gitリポジトリに混在した改行コードがコミットされると、差分が常に「全行変更」のように見えてレビューしづらい
• シェルスクリプトや設定ファイルでは、意図しないrが混入するだけで実行エラーになることがあります

そのため、Javaエンジニアであっても「OSごとの改行コード」と「プロジェクトで採用する基準」は意識しておく必要があります。

Javaで改行を出力する基本テクニックと注意点

ここからは、Javaコードの中で改行を扱う基本パターンを整理します。

System.out.printlnとprintの使い分けと注意点

もっともよく使うのがSystem.out.print / System.out.printlnです。

System.out.print("Hello"); // 改行なし
System.out.println("World"); // 出力後にOS依存の改行を付与

さらに、printlnは実行環境の改行コードに合わせて改行を出力します。そのため、コンソールログや簡単なデバッグ出力では、特別な理由がない限りprintlnを使っておけばOS依存を意識せずに済みます。

一方で、printで自分で改行を制御したい場合、次のようにnを直接書きたくなることがあります。

System.out.print("Hellon"); // 常にLF（n）で改行

しかし、この書き方は「常にLFで改行する」という意味になるため、テキストファイル出力などに流用すると、Windows環境（CRLFが標準）との整合性が崩れる場合があります。そのため、コンソール以外の用途では、後述するSystem.lineSeparator()を使う方が安全です。

ファイル入出力で安全に改行を書くnewLineメソッド

ファイル出力ではBufferedWriterやPrintWriterなどの「ライター系クラス」を利用することが多く、このときはnewLine()やprintln()を活用するのが基本です。

例えば、BufferedWriterを使う場合はnewLine()メソッドがOSに合わせた改行を自動で挿入します。

try (BufferedWriter writer =
new BufferedWriter(new FileWriter("sample.txt"))) {

writer.write("1行目のテキスト");
writer.newLine(); // OSに合わせた改行を挿入
writer.write("2行目のテキスト");
} catch (IOException e) {
    e.printStackTrace();
}

一方で、PrintWriterを使う場合はprintln()が同様の役割を担います。このように、ライブラリ側に改行処理を任せることで、OSによらず正しい改行コードが出力されます。詳細な仕様はOracleの公式ドキュメントも合わせて確認しておくと安心です。

OS依存しない改行処理を実現する方法

ここからは、「どの環境でも同じように動く改行処理」を実現するための代表的な方法を見ていきます。

System.lineSeparator()とgetProperty("line.separator")の活用

Java 7以降ではSystem.lineSeparator()が用意されており、実行中のOSに適した改行文字列をString型で取得できます。これは、ファイルパスや文字列結合で改行を挿入する場合に最適です。

String ls = System.lineSeparator(); // 実行OSがWindowsなら "rn"、Linuxなら "n"
String message = "1行目" + ls + "2行目";
System.out.print(message);

さらに、古いコードや既存ライブラリでは、同等の機能として次のように書かれていることもあります。

String ls = System.getProperty("line.separator"); // 非推奨だが同等の機能

しかし、新規開発では可読性と意図の明確さからSystem.lineSeparator()を使う方が推奨されます。詳しい仕様はOracleのSystemクラスのリファレンスが参考になります。

Java 15以降のテキストブロックの使い方と改行仕様

複数行文字列を「ソースコード中にそのまま書きたい」ケースでは、Java 15で正式機能となったテキストブロック（JEP 378）が非常に便利です。

String html = """

Hello Java

"""; // 終端の """; の位置に注意

さらに、従来のようにnを手作業で挟む必要がなく、画面上の見た目と実際の文字列の改行位置が一致するため、メンテナンス性も向上します。

ただし、テキストブロックで定義される改行は基本的にLF（n）ベースで扱われる点には注意が必要です。そのため、「ファイルに書き出すときはBufferedWriter#newLine()を使う」「プロトコル仕様上、改行コードが固定されている場合は明示的にrnを使う」など、用途ごとに方針を決めておきましょう。

⚠️ 改行コードが原因で起こりやすいトラブルと対策

ここまでの知識があっても、チーム開発や環境移行時には改行コードが原因のトラブルに遭遇することがあります。

エディタ・Git設定による差分肥大化と解決策

よくあるのが「エディタ設定の違いにより、改行コードがファイルごとにバラバラになる」ケースです。

• WindowsユーザーはCRLF、LinuxユーザーはLFで保存してしまう
• IDEのデフォルト設定がプロジェクト方針と異なっている
• 既存ファイルを開いた瞬間に自動変換され、差分が全行に及ぶ

そのため、チーム開発では次のような対策が有効です。

• プロジェクトのコーディング規約で「採用する改行コード」を明文化する
• .editorconfigやIDE設定で改行コードを統一し、自動変換をオフにする
• Gitのcore.autocrlf設定や.gitattributesで挙動を揃える

シェルスクリプトやツールで起きる改行混在エラー

一方で、より直接的なトラブルとしてシェルスクリプトの実行エラーがあります。

• Windowsで作成した.shファイルをLinuxに持ち込むと、先頭行の#!/bin/bash行の末尾にrが残り、command not foundになる
• 解析ツールやビルドスクリプトが、想定外の改行コードによってパースに失敗する

このようなケースでは、次のような方針で対処します。

• 可能であれば、スクリプト類はターゲットOS上で作成・編集する
• すでに混在している場合は、dos2unixなどの変換ツールで一括修正する
• IDEやエディタ側で「このプロジェクトではLF固定」などの設定を施す

こうした運用上の工夫に加え、Java側でもSystem.lineSeparator()やライター系クラスを活用しておけば、アプリケーションコード由来の改行トラブルは大幅に減らせます。

まとめ：改行コードを理解して環境差を吸収しよう

Javaで改行を扱う際のポイントを整理します。

• 改行コードにはLF（n）・CRLF（rn）・CR（r）があり、OSごとにデファクトスタンダードが違います
• コンソール出力はSystem.out.printlnを利用し、OS依存をなるべく意識せず扱えます
• ファイル出力ではBufferedWriter#newLine()やPrintWriter#println()など、ライブラリに任せる書き方が安全です
• 文字列として改行を挿入する場合は、System.lineSeparator()を使うことで環境依存を避けられます
• Java 15以降のテキストブロックを使えば、複数行文字列を自然な形で記述でき、改行位置も把握しやすくなります
• エディタ設定・Git設定・スクリプトの改行混在は、プロジェクト全体の運用ルールで早めに統一することが重要です

このように、改行コードを正しく理解しておくと、OSやツールの違いに振り回されない安定した開発環境を構築できます。そのため、Javaの文法だけでなく、周辺ツールや運用ルールと合わせて「改行の扱い方」をチームで共有しておくと、長期的な保守性や生産性の向上につながるはずです。