| 系統 | 換行符 | 十六進制 | 代表 |
|---|---|---|---|
| Windows (DOS/CP/M 繼承) | CRLF | 0x0D 0x0A | \r\n |
| Unix/Linux/macOS (現代) | LF | 0x0A | \n |
| Classic Mac OS (OS 9 及之前) | CR | 0x0D | \r |
| 場景 | 現象 | 根因 |
|---|---|---|
| Linux 建檔 → Windows 記事本開啟 | 全部內容擠在一行 | 記事本舊版僅識別 CRLF,忽略單獨 LF |
| Windows 建檔 → Linux vim/cat 開啟 | 行尾顯示 ^M (即 CR) | vim 若檢測到純 CRLF 自動以 DOS 模式顯示隱藏 ^M;混合換行則以 Unix 模式顯示露出 ^M |
| Git 跨平台協作 | 提交顯示大量換行變更、合併衝突 | core.autocrlf 設定不一致 |
| Shell 腳本/Python/容器啟動失敗 | 「bad interpreter: No such file」 | Shebang 行尾帶 CR (\r\n),核心嘗試尋找帶 \r 的解釋器路徑 |
| wc -l 統計行數少一行 | 最後一行無換行符 | POSIX 定義「行」以 LF 結尾;Windows 慣例最後一行不換行 |
# 顯示不可見字元 (vim)
:set list # 顯示 $ (LF), ^M (CR), ^I (Tab)
:set listchars=tab:>-,trail:~,eol:$,extends:>,precedes:<
# cat -A (顯示 $=LF, ^M=CR, ^I=Tab)
cat -A file.txt
# hexdump 逐位元檢查
hexdump -C file.txt | head -20
# file 命令識別
file file.txt
# ASCII text, with CRLF line terminators
# ASCII text (LF only)
| 工具 | CRLF → LF | LF → CRLF | 備註 |
|---|---|---|---|
| dos2unix / unix2dos | dos2unix file | unix2dos file | 最標準,需安裝 |
| sed | sed -i 's/\r$//' file | sed -i 's/$/\r/' file | 無需額外安裝,注意原地修改風險 |
| tr | tr -d '\r' < in > out | awk '{print $0 "\r"}' in > out | tr 只能刪除單字元 |
| vim | :set ff=unix | :w | :set ff=dos | :w | ff=fileformat |
| Notepad++ | 編輯 → 文件格式 → Unix (LF) | 編輯 → 文件格式 → Windows (CRLF) | 圖形化直觀 |
| VS Code | 右下角 CRLF 點擊切換 LF | 同左 | 即時轉換並儲存 |
# 建議:提交時轉 LF,檢出時不轉 (保持 LF),由編輯器/工具處理顯示
git config --global core.autocrlf input # Linux/macOS 推薦
git config --global core.autocrlf true # Windows 推薦 (檢出轉 CRLF,提交轉 LF)
# 強制倉庫統一行為 (優先於全域設定),提交到 .gitattributes
* text=auto eol=lf
*.bat text eol=crlf
*.cmd text eol=crlf
*.sh text eol=lf
.gitattributes 併入版控,確保團隊行為一致,避免「換行符大戰」。
"files.eol": "\n" (settings.json) + 底部狀態列隨時切換。Unix and macOS (\n)。// C# 讀取跨平台文本
var lines = File.ReadAllLines(path); // 自動處理 \r\n, \n, \r
var text = File.ReadAllText(path).Replace("\r\n", "\n").Replace("\r", "\n"); // 正規化
// Java
List lines = Files.readAllLines(Paths.get(path)); // 自動處理
// Python 3 通用新行模式
with open(path, 'r', newline='') as f: # newline='' 保留原始換行
content = f.read()
lines = content.splitlines() # 正確分割 \n, \r, \r\n
# 原檔:全 CRLF (\r\n)
sed 's/pattern/replacement/' file.txt
# 結果:匹配行的 \r 被視為普通字元匹配進 pattern space,替換後該行變 LF (\n),其他行仍 CRLF
# → 混合換行 → vim 以 Unix 模式顯示 → 露出 ^M
對策: 先 dos2unix 統一轉 LF 再處理,或用 sed -i 's/\r//g' 先去 CR。
換行符差異是跨平台開發的「隱形殺手」。建立統一規範:倉庫存 LF、編輯器存 LF、Git 用 .gitattributes 鎖定、CI/CD 檢查換行符、腳本/容器務必 LF。工具鏈現代化 (VS Code, Git, Docker) 已大幅降低認知負擔,關鍵在於團隊協約落地。