改行コードの違いとは?CRLF・LF・CRの見分け方と変換のしかた

テキストファイルを開いたら、改行がおかしい。1行にくっついて表示される。Gitで「LFがCRLFに置き換わります」と警告が出た。
こんな経験はありませんか。原因の多くは改行コードの違いです。この記事では、改行コードの種類と、トラブルを防ぐ方法を短く説明します。
改行コードは3種類ある
見た目は同じ「改行」でも、ファイルの中には目に見えない制御文字が入っています。
| 名前 | 中身 | 主に使われる環境 |
|---|---|---|
| LF | 改行(Line Feed) | Linux・macOS・Webサーバー |
| CRLF | 復帰+改行 | Windows |
| CR | 復帰(Carriage Return) | 昔のMac(今はほぼ使わない) |
昔のタイプライターには「紙を送る(LF)」動きと「キャリッジを左端へ戻す(CR)」動きがありました。その名残です。
違うとどうなるのか
1行につながって見える
LFだけのファイルを、古いメモ帳などで開くと、改行されずに全部が1行で表示されることがあります。最近のメモ帳はLFにも対応しています。それでも、一部のソフトでは今も起こります。
スクリプトが動かない
Linuxで動かすシェルスクリプトにCRLFが混ざると、次のようなエラーが出ることがあります。
bad interpreter: No such file or directory$'\r': command not found
行末に見えない「CR」が残り、コマンドの名前の一部だと読まれてしまうためです。Windowsで書いたスクリプトをサーバーへ置いたときによく起きます。
Gitの差分が全行変わる
チームの一人がCRLF、別の人がLFで保存すると、中身を変えていなくても全行が変更扱いになります。レビューがとても大変になります。
CSVが崩れる
セルの中の改行と、行の区切りの改行が混ざると、取り込み時に行がずれることがあります。
自分のファイルの改行コードを調べる方法
- エディタで確認する: VS Codeなら、画面右下に「LF」または「CRLF」と出ています。クリックすると切り替えられます。
- コマンドで確認する: Linux・macOSでは
file ファイル名で「with CRLF line terminators」と表示されます。 - ツールで確認する: 文章を貼り付けて、改行コードを調べて変換する方法もあります。
変換のしかた
エディタで変換する
VS Codeの右下の「CRLF」をクリックし、「LF」を選んで保存します。ほかのエディタにも、同じ機能があります。
コマンドで変換する
sed -i 's/\r$//' script.sh
これで行末のCRを消せます(CRLFからLFへ)。dos2unix script.sh が使える環境なら、それでも変換できます。
ブラウザのツールで手軽に変換する
ファイルを開かず、文字列だけ直したいときは、ブラウザで使える変換ツールが便利です。貼り付けて「LFにそろえる」「CRLFにそろえる」を押すだけです。当サイトの改行コード変換ツールなら、入力した文字はブラウザの中だけで処理されます。外部へ送られないので、社内の文書にも使いやすいです。
トラブルを防ぐ3つの習慣
1. チームで決める
「このプロジェクトはLFにそろえる」と決めておくと、差分がきれいになります。迷ったら、Web開発ではLFが標準的です。
2. .gitattributes で固定する
Gitを使うなら、リポジトリに .gitattributes を置き、次のように書く方法があります。
* text=auto eol=lf
こうすると、誰がどのOSで作業しても、改行がLFにそろいます。Windowsの .bat ファイルだけはCRLFが必要になることがあるので、その場合は個別に指定します。
3. エディタの設定をそろえる
.editorconfig に end_of_line = lf と書いておくと、対応エディタが自動でそろえてくれます。
まとめ
- 改行コードは LF・CRLF・CR の3種類
- Windowsは主にCRLF、Linux・macOSはLF
- 違いがあると、1行表示・スクリプトのエラー・Git差分の増加が起きる
- 変換はエディタ、コマンド、ブラウザのツールのどれでもできる
- チームで1つに決めて、設定ファイルで固定するのが一番確実
今困っているなら、まず改行コード変換ツールで、目的の形にそろえてみてください。
