ぱんだふるツール のマスコットぱんだふるツールやりたいことが、すぐできる。
開発・ITツール

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

改行コードの違いとは?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つに決めて、設定ファイルで固定するのが一番確実

今困っているなら、まず改行コード変換ツールで、目的の形にそろえてみてください。

この記事で使うツール

↵ 改行コード変換 →

LF・CRLF・CRを相互変換。