# Pengakhiran baris: LF, CRLF dan CR, dan cara pengesan ini mengira

> Apa itu LF, CRLF dan CR tunggal, mengapa pulangan bawa sesat merosakkan skrip dan perbezaan, apa tepatnya yang dikira dan tidak dapat dilihat pengesan, serta semakan baris perintah dan Git, dengan output daripada fail sebenar.

- Tool: [Pengesan Pengakhiran Baris (LF vs CRLF)](https://toolsg.com/ms/line-ending-detector)
- Language: ms (available: en, zh, ms, ta)
- Last verified against official sources: 2026-10-20
- Source site: ToolSG — a planning guide, not official or financial advice. Cite the agencies listed under Sources.

## Angka utama sepintas lalu

| Perkara | Nilai | Sumber |
| --- | --- | --- |
| LF (\n) | U+000A, digunakan oleh fail teks Unix, Linux dan macOS — POSIX mentakrifkan baris sebagai aksara bukan baris baharu ditambah baris baharu penamat. | [The Open Group — POSIX definitions](https://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap03.html) |
| CRLF (\r\n) | U+000D U+000A, konvensyen Windows — RFC 4180 menentukan CRLF di antara rekod CSV. | [IETF — RFC 4180](https://www.rfc-editor.org/rfc/rfc4180.html) |
| Apa yang dikira pengesan | Pemisah baris, bukan baris — LF tanpa CR sebelumnya, dan CRLF. CR tunggal tidak dikira. |  |
| Kelakuan kawasan teks | Teks yang ditaip sentiasa dibaca semula dengan LF sahaja — Tampalan yang menggantikan seluruh kotak dan butang penukaran mengekalkan CRLF; menaip selepas itu membuangnya. |  |

## Membetulkan skrip yang gagal di Linux akibat masalah CRLF

Skrip shell yang disimpan dengan pengakhiran baris Windows sering gagal dengan ralat 'tidak ditemui' yang mengelirukan.

1. **Sahkan pengakhiran baris** — Jalankan file script.sh, atau tampal teks di sini dan tekan Analisis. Cari CRLF dalam output.
2. **Tukar kepada LF** — Tekan Tukar kepada LF dan gunakan Salin atau Muat turun, atau jalankan sed -i 's/\r$//' script.sh dalam terminal.
3. **Semak baris pertama semula** — Baris shebang mesti berakhir dengan LF sahaja. Sahkan dengan cat -A script.sh: tiada ^M sebelum $.
4. **Halang ia berulang** — Tambah peraturan .gitattributes seperti *.sh text eol=lf supaya Git menulis LF pada setiap checkout.

## Tiga jenis pengakhiran baris

| Nama | Aksara | Asal lazim |
| --- | --- | --- |
| LF | `\n`, U+000A | Unix, Linux, macOS, kebanyakan fail web dan sumber |
| CRLF | `\r\n`, U+000D U+000A | Fail teks Windows, banyak protokol rangkaian dan CSV mengikut RFC 4180 |
| CR | `\r`, U+000D | Mac OS klasik, kini jarang |

POSIX mentakrifkan *baris* sebagai "jujukan sifar atau lebih aksara bukan baris baharu ditambah aksara baris baharu penamat". Maka `wc -l` mengira baris baharu, bukan baris yang kelihatan: `one⏎two` tanpa baris baharu akhir melaporkan 1, dan `one⏎two⏎` melaporkan 2. "Baris tidak lengkap" ialah teks di hujung fail tanpa baris baharu penamat.

## Apa yang dilaporkan pengesan

Tampal teks dan tekan **Analisis Pengakhiran Baris**. Ia mengira dua perkara dengan ungkapan nalar: LF yang tidak didahului CR, dan pasangan CRLF. Panel menunjukkan **jumlah** (LF ditambah CRLF, iaitu bilangan pemisah baris, kurang satu daripada bilangan baris jika teks tiada baris baharu akhir), bilangan LF, bilangan CRLF, dan keputusan: LF sahaja, CRLF sahaja, atau Bercampur (kedua-duanya ada). Jika tiada pemisah ia berkata "Tiada pemisah baris dikesan".

Disahkan pada halaman sebenar:

| Ditampal (menggantikan kotak) | Hasil |
| --- | --- |
| `one\r\ntwo\r\nthree\r\n` | jumlah 3, LF 0, CRLF 3, "CRLF (Windows — pulangan pembawa dan suapan baris)" |
| `one\ntwo\r\nthree\n` | jumlah 3, LF 2, CRLF 1, "Bercampur" |
| `one\ntwo\nthree\n` | jumlah 3, LF 3, CRLF 0, "LF (Unix/Linux/macOS — suapan baris)" |
| `a\rb\rc` (CR sahaja) | "Tiada pemisah baris dikesan": CR tunggal tidak dikira |

**Tukar kepada LF** menukar CRLF dan CR tunggal kepada LF. **Tukar kepada CRLF** mula-mula menormalkan semuanya kepada LF kemudian menulis CRLF, jadi teks bercampur menjadi konsisten. Salin dan Muat turun menggunakan teks yang ditukar itu; muat turun dinamakan `text-with-line-endings.txt`.

## Apa yang tidak dapat dilihat halaman

Kawasan teks pelayar tidak menyimpan aksara anda secara verbatim. Piawaian HTML menyatakan getter nilainya memulangkan teks "dengan baris baharu dinormalkan", yang bermakna CRLF dan CR dibaca semula sebagai LF. Halaman ini mengatasinya untuk dua kes sahaja: tampalan yang menggantikan keseluruhan kandungan kotak, dan teks yang dihasilkan oleh butang penukarannya sendiri. Dalam kedua-dua kes aksara CR asal disimpan bersama kawasan teks dan digunakan untuk analisis, penyalinan dan muat turun.

Selainnya LF sahaja:

- Teks yang anda taip, atau tampal di tengah teks sedia ada, dibaca semula dengan LF sahaja; jadi ia dilaporkan sebagai LF walaupun teks yang ditampal ialah CRLF.
- Sebaik sahaja anda menaip apa-apa selepas tampalan atau penukaran, aksara CR hilang dan halaman bekerja pada teks LF sahaja.
- CR tunggal tidak pernah dikira, jadi fail gaya Mac lama melaporkan "Tiada pemisah baris dikesan" sehingga anda menukarnya.

Bagi fail pada cakera, terminal memberi jawapan yang benar.

## Memeriksa fail sebenar

Output daripada fail yang dicipta dengan `printf`:

| Kandungan fail | `file` berkata | `od -c` menunjukkan |
| --- | --- | --- |
| `one\ntwo\nthree\n` | ASCII text | `\n` selepas setiap perkataan |
| `one\r\ntwo\r\nthree\r\n` | ASCII text, with CRLF line terminators | pasangan `\r \n` |
| `one\rtwo\rthree\r` | ASCII text, with CR line terminators | `\r` sahaja |
| `one\ntwo\r\nthree\n` | ASCII text, with CRLF, LF line terminators | kedua-duanya |

`wc -l` mencetak 3, 3, 0 dan 3 bagi keempat-empat fail itu. Fail CR sahaja mempunyai sifar baris baharu, jadi alat yang membaca baris demi baris melihatnya sebagai satu baris panjang. `cat -A file` menunjukkan `^M` sebelum `$` pada baris CRLF, dan `grep -c $'\r' file` mengira baris yang mengandungi CR. Dalam repositori Git, `git ls-files --eol` menyenaraikan pengakhiran baris yang direkodkan dalam indeks (`i/`) dan pokok kerja (`w/`): ia mencetak `i/lf`, `i/crlf`, `i/mixed`, dan `i/-text` untuk fail CR sahaja, yang tidak dianggap teks oleh Git.

## Mengapa ia penting

Skrip yang bermula dengan `#!/bin/sh` diikuti pulangan bawa menamakan penterjemah `/bin/sh\r`. Dijalankan terus dalam shell bash, ia gagal dengan "cannot execute: required file not found", manakala `sh script.sh` berjalan tetapi setiap baris membawa CR sesat di hujungnya. Selepas `sed -i 's/\r$//' script.sh`, skrip yang sama berjalan dan mencetak `hi`. Kesan lain: perbezaan seluruh fail apabila satu penyunting menulis semula setiap pengakhiran baris, perbandingan rentetan gagal, dan `\r` yang terselamat sehingga medan terakhir nilai CSV atau konfigurasi.

## Git dan pasukan

Git boleh menormalkan pengakhiran baris, tetapi hanya jika diberitahu. Menetapkan `text=auto` dalam `.gitattributes` menyebabkan Git memutuskan sama ada fail itu teks dan menormalkan CRLF kepada LF dalam indeks; `eol=lf` atau `eol=crlf` menetapkan apa yang ditulis ke pokok kerja; tanpa kedua-duanya, `core.autocrlf` memutuskan. Peraturan permulaan lazim ialah `* text=auto`, kemudian `git add --renormalize .` sekali untuk menukar fail sedia ada. Dokumentasi Git menerangkan prosedur penormalan semula itu sepenuhnya.

> **Petua:** Pilih `.gitattributes` peringkat projek berbanding `core.autocrlf` setiap pembangun, supaya peraturan itu mengikut repositori.

## Kesilapan biasa

- Membaca "Jumlah" sebagai bilangan baris. Ia mengira pemisah baris.
- Menampal di tengah teks sedia ada dan mempercayai keputusan "LF" untuk input CRLF.
- Menyunting selepas menukar kepada CRLF dan kemudian memuat turun; menaip membuang CR.
- Menukar fail binari, yang boleh mengandungi bait yang kelihatan seperti CR atau LF dengan sah.
- Terlupa baris baharu akhir: alat POSIX menganggap teks terakhir yang tidak ditamatkan sebagai baris tidak lengkap.

## Alat berkaitan

Cari aksara tak kelihatan lain dengan [pembersih aksara tersembunyi](https://toolsg.com/ms/hidden-character-cleaner), bandingkan dua versi dengan [perbandingan teks](https://toolsg.com/ms/text-diff), atau lihat bait rentetan dengan [penukar teks ke heks](https://toolsg.com/ms/text-to-hex).

## Soalan lazim

**Apakah perbezaan antara pengakhiran baris LF dan CRLF?**

LF (Line Feed) ialah satu aksara (\n, ASCII 10) yang digunakan oleh sistem Unix, Linux dan macOS untuk pengakhiran baris. CRLF (Carriage Return + Line Feed) ialah jujukan dua aksara (\r\n, ASCII 13 + 10) yang digunakan oleh Windows dan DOS. Perbezaan ini berpunca daripada mekanisme mesin taip dan teletype lama di mana carriage return mengembalikan kepala cetak ke permulaan baris, manakala line feed menggerakkan kertas ke baris seterusnya. Sistem operasi moden mengekalkan konvensyen ini demi keserasian ke belakang.

**Mengapa pengakhiran baris penting dalam pengaturcaraan dan fail teks?**

Pengakhiran baris penting kerana format yang salah boleh menyebabkan pelbagai isu: skrip shell mungkin gagal dijalankan, sistem kawalan versi boleh menunjukkan fail sebagai berubah walaupun hanya pengakhiran baris berbeza, editor teks mungkin memaparkan fail dengan salah, pengkompil boleh menghasilkan ralat dan kerjasama rentas platform boleh menjadi bermasalah. Pengakhiran baris yang konsisten memastikan tingkah laku yang boleh dipercayai merentas sistem dan alat berbeza.

**Bagaimana saya boleh mengesan pengakhiran baris yang digunakan oleh fail saya?**

Tampal kandungan fail anda ke dalam alat ini dan klik "Analisis Pengakhiran Baris." Alat ini akan menunjukkan statistik terperinci termasuk bilangan baris LF, baris CRLF, sama ada anda mempunyai pengakhiran baris bercampur dan format dominan. Anda juga boleh menggunakan editor teks seperti VS Code (memaparkan "LF" atau "CRLF" pada bar status), Notepad++ (View → Show Symbol → Show End of Line), atau alat baris arahan seperti "file" pada sistem Unix.

**Patutkah saya menggunakan LF atau CRLF untuk projek saya?**

Untuk kebanyakan pembangunan moden, LF (gaya Unix) disyorkan walaupun di Windows kerana kebanyakan alat pembangunan menyokongnya. Gunakan LF untuk kod sumber, skrip shell, fail konfigurasi dan fail teks umum. Gunakan CRLF hanya untuk fail yang benar-benar diperlukan di Windows (seperti fail .bat atau .cmd). Perkara paling penting ialah konsistensi - pilih satu format dan gunakannya di seluruh projek anda.

**Apakah pengakhiran baris bercampur dan mengapa ia bermasalah?**

Pengakhiran baris bercampur berlaku apabila satu fail mengandungi kedua-dua LF dan CRLF. Ini biasanya berlaku apabila beberapa orang mengedit fail menggunakan editor teks yang berbeza dengan tetapan berlainan, atau apabila menyalin dan menampal kod dari sumber yang berbeza. Pengakhiran baris bercampur boleh menyebabkan tingkah laku tidak menentu, menjadikan diff sukar dibaca, mencetuskan ralat linting dan menyebabkan skrip gagal. Sentiasa seragamkan kepada satu format pengakhiran baris.

**Bagaimana saya membetulkan isu pengakhiran baris dalam Git?**

Konfigurasikan Git untuk mengendalikan pengakhiran baris secara automatik dengan mencipta fail .gitattributes dalam repositori anda menggunakan "* text=auto". Ini memberitahu Git untuk menyeragamkan pengakhiran baris kepada LF dalam repositori dan menukarnya kepada format yang sesuai dengan platform semasa checkout. Anda juga boleh menggunakan "git config --global core.autocrlf" (tetapkan kepada "true" di Windows, "input" di Mac/Linux). Untuk fail sedia ada yang mempunyai pengakhiran baris salah, gunakan alat ini untuk menukarnya dan kemudian commit perubahan tersebut.

**Bolehkah pengakhiran baris yang salah merosakkan skrip shell saya?**

Ya, skrip shell dengan pengakhiran baris CRLF biasanya akan gagal dijalankan pada sistem Unix/Linux. Pentafsir shell akan melihat carriage return (\r) sebagai sebahagian daripada arahan, lalu menyebabkan ralat seperti "command not found" atau "bad interpreter." Jika anda mengedit skrip shell di Windows, sentiasa pastikan ia menggunakan pengakhiran baris LF sebelum menggunakannya di pelayan Unix/Linux. Alat ini boleh menukar CRLF kepada LF dengan segera.

**Bagaimana saya boleh mencegah masalah pengakhiran baris dalam pasukan saya?**

Tetapkan konvensyen pasukan (biasanya LF untuk pembangunan moden), cipta fail .gitattributes untuk menguatkuasakannya, konfigurasikan IDE atau editor supaya menggunakan pengakhiran baris konsisten, tambah semakan pengakhiran baris dalam pipeline CI/CD, dokumentasikan standard dalam README projek dan gunakan pre-commit hooks untuk mengesahkan pengakhiran baris sebelum commit. Alat ini boleh membantu ahli pasukan menyemak dan membetulkan pengakhiran baris sebelum menolak kod.

**Adakah alat ini menghantar teks saya ke pelayan?**

Tidak, semua pengesanan dan penukaran pengakhiran baris berlaku sepenuhnya dalam pelayar web anda menggunakan JavaScript. Teks anda tidak pernah meninggalkan peranti anda atau dihantar ke mana-mana pelayan. Ini menjadikan alat ini selamat sepenuhnya untuk menganalisis kod sensitif, fail konfigurasi atau skrip proprietari. Alat ini juga berfungsi di luar talian selepas pemuatan halaman awal.

**Apakah perbezaan saiz fail antara LF dan CRLF?**

Pengakhiran baris CRLF menggunakan dua bait bagi setiap pengakhiran baris (\r\n), manakala LF menggunakan hanya satu bait (\n). Untuk fail yang mempunyai banyak baris, ini boleh menghasilkan perbezaan saiz yang ketara. Contohnya, fail dengan 1,000 baris akan lebih kurang 1KB lebih besar dengan CRLF berbanding LF. Walaupun biasanya tidak signifikan untuk kod sumber, ia penting bagi fail yang sangat besar atau apabila mengoptimumkan lebar jalur dan storan.

**Bolehkah saya menggunakan alat ini untuk fail besar?**

Ya, alat ini boleh mengendalikan fail teks dalam apa-apa saiz kerana semua pemprosesan dilakukan secara setempat dalam pelayar anda. Namun, fail yang sangat besar (beberapa megabait atau lebih) mungkin mengambil sedikit masa untuk diproses bergantung pada prestasi komputer anda. Untuk fail yang sangat besar, anda mungkin mahu menggunakan alat baris arahan seperti dos2unix atau unix2dos yang dioptimumkan untuk pemprosesan kelompok.

**Bagaimana pengakhiran baris mempengaruhi Docker container?**

Semasa membina Docker container, skrip shell dan fail konfigurasi mesti menggunakan pengakhiran baris LF (Unix) walaupun anda membangunkan di Windows. Jika anda menyalin skrip shell dengan pengakhiran baris CRLF ke dalam Linux container, skrip itu akan gagal dijalankan. Sentiasa sahkan bahawa Dockerfile, skrip shell dan fail konfigurasi anda menggunakan LF sebelum membina imej container. Alat ini boleh menukar fail yang diedit di Windows kepada format Unix dengan cepat.


## Sumber rujukan

- [The Open Group — POSIX.1-2017 Base Definitions, chapter 3](https://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap03.html) — Definitions of Line (3.206), Incomplete Line (3.195) and Newline Character (3.243).
- [IETF — RFC 4180, Common Format and MIME Type for CSV Files](https://www.rfc-editor.org/rfc/rfc4180.html)
- [Git documentation — gitattributes](https://git-scm.com/docs/gitattributes) — text, eol and text=auto; core.autocrlf.
- [WHATWG HTML Standard — The textarea element](https://html.spec.whatwg.org/multipage/form-elements.html) — The value getter returns the API value, with newlines normalised to LF.
