CRLF vs. LF Windowsissa: Muunna, konfiguroi ja vältä projektien aiheuttamat ongelmat

Viimeisin päivitys: 04/09/2025
Kirjoittaja: Isaac
  • LF (unix) ja CRLF (Windows) ovat erilaisia ​​rivinloppuja; standardoi ne eroavaisuuksien ja virheiden välttämiseksi.
  • Git ratkaisee ongelman core.autocrlf- ja .gitattributes-tiedostoilla; se käyttää * text=auto -ominaisuutta ja point-sääntöjä.
  • Määritä editori (VS Code/Visual Studio) ja normalisoi tarvittaessa uudelleen komennolla git add --renormalize .
  • Pidä LF-tiedosto arkistossa ja anna Windowsin käyttää CRLF-tiedostoa työkopiossa tarvittaessa.

Muunna rivinvaihtomuotojen välillä Windowsissa

Jos työskentelet Windowsilla ja vuorottelet projekteja Linux- tai macOS-käyttäjien kanssa, ennemmin tai myöhemmin törmäät ikuiseen CRLF vs. LF -taisteluun . Joskus se tuntuu mustalta magialta: muokkaat tiedostoa, etkä muuta mitään "näkyvää", ja Git merkitsee puolet tiedostosta muokatuksi. Älä huoli, kyse ei ole noituudesta; kyse on rivinlopuista, jotka työskentelevät sinua vastaan.

Päänsäryn välttämiseksi on hyödyllistä ymmärtää, mitä alla tapahtuu ja miten Gitiä, editoria ja työkaluja säädetään niin, että jokainen tiedosto saapuu repositorioon "puhtaana", ilman haamumuutoksia tai outoja virheitä CI/CD:ssä tai skripteissä. Tässä oppaassa selitän yksityiskohtaisesti ja ytimekkäästi, miten CRLF ja LF muunnetaan, konfiguroidaan ja normalisoidaan Windowsissa tuhlaamatta aikaa.

Mitä ovat LF ja CRLF ja miksi ne ovat tärkeitä?

Rivinloput ovat ohjausmerkkejä, jotka rajaavat tekstitiedoston rivit: LF (\n, ASCII 10) ja CRLF (\r\n, ASCII 13+10) . Unixin kaltaiset järjestelmät (Linux, macOS) käyttävät LF-merkkiä , kun taas Windows käyttää CRLF-merkkiä tulostimista ja kirjoituskoneista periytyneen järjestelmän vuoksi: ensin rivinvaihto (CR), sitten rivinvaihto (LF).

Valinta ei ole pelkästään esteettinen: vaihtaminen muodosta toiseen voi aiheuttaa keinotekoisia vertailuja , skriptejä, jotka epäonnistuvat "komentoa ei löytynyt" -virheen vuoksi, prosesseja, jotka kaatuvat CRLF:llä tallennettuja tiedostoja Linuxissa, tai editorit, jotka näyttävät kaiken yhdellä rivillä. Kyllä, .sh-tiedoston avaaminen CRLF:llä Bashissa voi olla ikävä yllätys.

Pyöristääkseen asian Unicode tunnistaa useampia erottimia (NEL U+0085, LS U+2028, PS U+2029, VT U+000B, FF U+000C), mutta jokapäiväisessä kehityksessä todellinen taistelu käydään CRLF:n ja LF:n välillä . Silti niiden olemassaolosta tietäminen on hyödyllistä, kun kohtaat suurtietokonetekstiä tai epätavallisia tiedostoja, joita vanhempi editori ei tulkitse hyvin.

Toinen hyödyllinen tekninen yksityiskohta: rivinvaihtoa voidaan käsitellä erottimena ( rivien välissä) tai terminaattorina (merkitsee lopun). Tämä hienovaraisuus selittää, miksi joskus näet viimeisen rivin ilman rivinvaihtoa tai ylimääräisiä tyhjiä rivejä, kun käytät työkaluja sekoituksessa. Jos sinun on opittava löytämään ja korvaamaan kappaleenvaihdot , huomaa, että jotkut jäsentimet odottavat yhtä tai toista.

CRLF- ja LF-erot käyttöjärjestelmän mukaan

Järjestelmien väliset erot ja tyypilliset ongelmat

Windowsissa standardi on CRLF ; Linuxissa ja macOS: ssä LF . Tämä ero on heti havaittavissa sekajärjestelmässä: joku muokkaa tiedostoa järjestelmällään, tallentaa sen, ja vertailutiedosto täyttyy muutoksista, jotka ovat itse asiassa vain rivinloppuja . Käytännössä tämä monimutkaistaa revisioita ja saastuttaa historian.

On myös sivuvaikutuksia: Unix-ympäristössä suoritettava CRLF-attribuuttia sisältävä skripti saattaa epäonnistua kryptisten virheiden vuoksi, tai CI-ympäristössä tehtävä voi katketa, koska komentotulkki tulkitsee palautusarvot väärin. Käänteisesti tiedoston avaaminen, jossa on vain LF, vanhemmissa Windows-editoreissa saattaa litistää sen yhdeksi riviksi.

Ole varovainen jatkuvan integraation työkalujen, kuten Jenkinsin tai GitHub Actionsin, kanssa: jos koontiversio toimii Linuxissa, mutta lataat tiedostoja, joiden rivinpäätteet ovat epäjohdonmukaisia, voit rikkoa prosessin, vaikka "kaikki toimisi koneellani". Monet ihmiset ovat menettäneet tuntikausia tämän takia.

Hyvä uutinen on, että tähän on olemassa selkeä ratkaisu: laadi käytäntö ja anna työkalujen soveltaa sitä automaattisesti . Tämä edellyttää Gitin ja editorisi käyttöä. Ja jos vahinko on jo tapahtunut, normalisoi repositorio uudelleen.

  Kaskadikansioiden ja alikansioiden luominen Windowsissa Excelin avulla

Muuten, nykyaikaiset editorit, kuten VS Code, näyttävät sivunvaihdon tyypin tilarivillä ja mahdollistavat sen muuttamisen lennossa; se on pelastus, kun havaitset "ristiviittauksia" sisältäviä tiedostoja ja haluat järjestää ne nopeasti uudelleen tai kun sinun on vältettävä odottamattomia sivunvaihtoja ja muotoiluja liitettäessä tekstiä dokumentteihin.

Gitin konfigurointi CRLF:lle ja LF:lle

Git ja rivinlopet: core.autocrlf ja .gitattributes

Git voi automaattisesti muuntaa rivinloput pitääkseen historian siistinä ja välttääkseen yllätyksiä. Keskeinen tässä on ` core.autocrlf` -asetus , joka sinun tulee ymmärtää hyvin ennen sen muokkaamista, ja olla tietoinen siitä, että kokoonpano voi olla globaali tai repositoriokohtainen (paikallinen asetus on etusijalla).

Tarkista globaali kokoonpanosi `--global`- valitsimella ja muista, että repositoriolla voi olla eri arvo, jolla on etusija. Jos haluat tarkastella kaikkea globaalisti, käytä `git config --list --global`-valitsinta . Jos huomaat epätavallista toimintaa repositoriossa, tarkista paikallinen arvo ja priorisoi se tarpeidesi mukaan.

Core.autocrlf-tilat käytännössä (Windows vs. Unix): `true` muuntaa CRLF-muotoon uloskirjauksen yhteydessä ja takaisin LF-muotoon commitin yhteydessä; `input` muuntaa LF-muotoon vain commitin yhteydessä (ihanteellinen Linuxissa/macOS:ssa); `false` ei tee mitään (ja on usein lyhytaikainen ratkaisu pitkäaikaisiin ongelmiin sekajärjestelmässä). Windowsissa ` true` on järkevin vaihtoehto , jos haluat välttää yllätyksiä.

Hyödyllisiä komentoja arkiston säätämiseen ja siivoamiseen tekemättä asioista liian monimutkaisia: jos haluat arkiston käyttävän globaalia arvoa, poista paikallinen avain; jos haluat pakottaa arvon kyseisessä arkistossa, määritä se ilman `--global`-valitsinta . Korjaa sekalaiset tiedostot normalisoimalla ne uudelleen ja tekemällä commit ryhmittelemällä rivinloppumuutokset.

git config --list --global
# Ver el valor global efectivo

git config --unset core.autocrlf
# Quitar el valor local y heredar el global

git config core.autocrlf true
# Fijar el valor solo en el repo actual (Windows)

git add --renormalize .
# Recorrerá el repo y homogeneizará line endings según la config

git commit -m 'Homogeneizados los cambios de línea'
# Sube un solo commit de normalización

Mutta on olemassa jotain vielä parempaa: juurihakemistossa oleva .gitattributes-tiedosto , joka kulkee koodin mukana. Säännöllä *text=auto käsket Gitin tunnistamaan tekstitiedostot ja käsittelemään rivinvaihdot oikein (LF repositoriossa; CRLF Windowsin työkopiossa, jos sovellettavissa). Ja voit hienosäätää sitä laajennuksilla, esimerkiksi pakottamalla Visual Studion .sln-tiedostot aina CRLF-muotoon.

* text=auto
# Homogeneiza automáticamente (LF en el repo)

*.sln text eol=crlf
# Asegura CRLF en soluciones de Visual Studio

Kun lisäät `.gitattributes`-tiedoston olemassa olevaan repositorioon, muista käyttää `git add --renormalize`-komentoa ja ryhmitellä commit. Tämä estää jokaista osallistujaa luomasta omaa "mega-commit-siivoustaan". Se on yksi niistä tehtävistä, jotka teet kerran ja jotka säästävät vaivaa vuosiksi.

Editorin määrittäminen: VS Code, EditorConfig ja Visual Studio

Myös editorillasi on suuri rooli. VS Codessa voit asettaa rivinvaihdot tilariviltä tai `files.eol` -asetuksella . Jos projektissasi käytetään rivinvaihtoja, valitse se vain, ja olet valmis; editori tallentaa automaattisesti ilman, että sinun tarvitsee käydä tiedosto tiedostolta läpi. Se on nopea ja välttää kohinaiset vertailut.

Jos kaikki tiimissä käyttävät eri editoria, EditorConfig-tiedoston (.editorconfig) lisääminen juurihakemistoon on pelastus: se määrittää johdonmukaisesti säännöt, kuten rivinloput, koodauksen ja välilyöntien/tabulaareiden asetukset. Useimmat nykyaikaiset editorit noudattavat sitä, ja se integroituu saumattomasti Gitin ja CI:n kanssa.

  Kuinka ratkaista WhatsApp Web ei toimi tietokoneellasi?

Visual Studion käyttäjille on oma paneelinsa (Tallennuksen lisäasetukset). Voit käyttää sitä valitsemalla Tiedosto > Tallenna nimellä > Tallenna-pudotusvalikosta > Tallenna koodauksella tai sijoittamalla Lisäasetukset suoraan Tiedosto-valikkoon nopeaa käyttöä varten.

  1. avautuu Työkalut > Mukauta.
  2. Tab komennot, valitse Valikkopalkki ja valitse arkisto.
  3. lehdistö Lisää komento, kategoria arkistoja lisää Tallennuksen lisäasetukset.
  4. Siirrä paikkaa Lähetä/Lataa ja sulje se. Se on valmiina.

Visual Studio voi myös kohdata tiedostoja, joissa on erilaisia ​​erottimia (NEL, LS, PS). IDE yrittää normalisoida ne , kun se havaitsee epäjohdonmukaisuuksia, ja pyytää sinulta ohjeita. .gitattribuuttien ja tallennusasetusten pitäminen oikein määritettynä estää projektisi täyttymisen epätavallisista tapauksista.

CRLF:n ja LF:n tuolla puolen: NEL, LS, PS ja yritys

Unicode käsittelee tiettyjä lisäkoodipisteitä rivinloppuina: NEL (U+0085) , LS (U+2028) ja PS (U+2029) sekä VT (U+000B) ja FF (U+000C) . Nämä eivät ole yleisiä sovellus-/verkkoprojekteissa, mutta niitä esiintyy IBM:n suurtietokoneissa (EBCDIC) ja joissakin vanhemmilla tai erityistyökaluilla käsitellyissä dokumenteissa.

Yhteensopivuuden varmistamiseksi Unicode kopioi ASCII-standardin mukaiset ohjausobjektit samoilla numeerisilla arvoilla (CR ja LF) ja lisää uusia arvoja häviöttömiä muunnoksia varten koodausten välillä (esim. EBCDIC NL:n yhdistäminen Unicode NEL:ään). Jos saat "oudon" tiedoston, moderni editori yleensä näyttää tai kehottaa sinua normalisoimaan sen.

Merkki kuvaus Unicode
CR LF Paluu + ennakko U+000D + U+000A
LF Rivinvaihto U+000A
NEL Seuraava rivi U + 0085
LS Rivin erotin U + 2028
PS Kappaleiden erotin U + 2029

Vanhemmissa Windowsin Muistio-versioissa edes LF- tiedosto ei näkynyt oikein; nykyään tuki on paljon parempi, mutta NEL on edelleen ongelmallinen joissakin ympäristöissä. Siksi repositorioiden ja CI/CD:n osalta voittava strategia on pitää kaikki LF-muodossa repositoriossa ja jättää työkopion CRLF Gitille/editorsille Windowsissa.

Ohjelmointikielet ja rivinvaihdot (\r, \n ja trap-merkit)

Merkkijonoissa monet kielet sallivat koodinvaihtosekvenssit: \n = LF , \r = CR . Näissä CRLF muodostetaan tarvittaessa muodossa \r\n tai lisätään "puhdas" LF \n:llä. Ole kuitenkin tietoinen siitä, etteivät kaikki ajonaikaiset ympäristöt toimi samalla tavalla.

Muistettavia tapauksia: Javassa on \ry\n:n lisäksi %n (muotoilijat) ja System.lineSeparator() järjestelmärivinvaihdon hakemiseksi kannettavalla tavalla; C# : ssa Environment.NewLine tekee saman; PHP: ssä on PHP_EOL ; Pythonissa os.linesep . Jos haluat tulostaa alustan mukaan, käytä näitä vakioita CRLF:n sijaan.

C- ja C++-kielten kanssa on oltava erityisen varovainen : tekstitilassa sekvenssi \n voidaan yhdistää järjestelmän rivinvaihtoon (CRLF Windowsissa), ja jos tulostat \r\n, voit luoda CRCRLF:n . Binääritilassa se on kirjaimellinen. Tämä hienovaraisuus yllättää monet käännettäessä Windowsissa ja testattaessa Linuxissa.

JavaScriptissä /TypeScriptissä \n riittää yleensä useimpiin käyttötarkoituksiin, mutta jos käsittelet Windows-käyttäjän syötettä, näet \r\n ja sinun on normalisoitava rivienvaihdot. Lisäksi HTML-koodia luotaessa lopullista asettelua ohjaavat tagit (p., br, p, h2…), eivät \r\n-merkit.

// C#
var s1 = "Primera\nSegunda";            // LF explícito
var s2 = "Primera" + Environment.NewLine + "Segunda"; // Salto del sistema

// Java
String a = "Uno\r\nDos";                 // CRLF explícito
String b = "Uno" + System.lineSeparator() + "Dos";    // Portátil

// Python
s = 'Linea1' + os.linesep + 'Linea2'

// JavaScript
const t = 'L1\nL2'; // Normaliza entrada si viene con \r\n

Jos tuotat verkkoliikennettä, muista, että protokollat, kuten HTTP, SMTP, FTP ja IRC, ovat tiukkoja: otsikoiden ja monien ohjausrivien on käytettävä CRLF:ää . Ei "keksintöjä": mukauta tulosteesi RFC:n mukaisesti tai kohtaat palvelimia, jotka hylkäävät pyyntösi.

  Videon muodon muuttaminen Kuvat- ja Clipchampin avulla Windows 11:ssä

Rivinloppujen luotettava tunnistaminen ja muuntaminen

Ei ole olemassa yhtä ainoaa "BOM"-luetteloa, joka kertoisi rivinvaihdon tyypin: sinun on tarkasteltava tavuja . Käytännössä työkalut laskevat CR (0x0D) ja LF (0x0A) -merkit ja analysoivat niiden kuvioita: jos ne esiintyvät pareittain, se on yleensä CRLF; jos vain 0x0A esiintyy, se on LF; jos sekoitus on epäjohdonmukainen, sinulla on sotku, joka on korjattava.

Jotkin editorit havaitsevat tämän ja varoittavat sinua; VS Code näyttää sen tilarivillä; Visual Studio saattaa tarjota normalisointia. Gitissä turvallisin tapa on määritellä `.gitattributes` ja tarvittaessa normalisoida uudelleen, jotta koko puu on linjassa käytännön kanssa. Repositoriosi (ja versiosi) kiittävät sinua.

Entä jos työskentelet "eksoottisten formaattien" kanssa? Editorit, kuten Notepad++ ja VS Code, käsittelevät CRLF:n ja LF:n hyvin ja yleensä tunnistavat LS/PS:n . NEL- ja EBCDIC-muotojen kohdalla sinun on joskus suoritettava koodauksen esimuunnos rivinvaihdon lisäksi.

Useimpien projektien voittava strategia on yksinkertainen: tallenna repositorioon LF- komennolla , ota automaattinen muunnos käyttöön Windowsissa ja estä poikkeukset eol=crlf- komennolla tiedostoille, jotka sitä tarvitsevat (esim. .sln). Kaikki muu on vältettävissä olevaa ongelmaa.

Sekalaiset rivinvaihdot sisältävä arkisto: sotkun korjaaminen

Se on hyvin yleistä: osa koodista on peräisin Linuxista (LF) ja toisia osia on muokattu Windowsissa (CRLF). Tuloksena on puu, jossa on sekavia rivejä, lukukelvottomia eroavaisuuksia ja ihmiset ihmettelevät, miksi heidän skriptinsä ei käynnisty tänään. Aika saada asiat järjestykseen.

Nopea ja turvallinen suunnitelma :

  1. lisää .gitattributes kanssa * teksti=automaattinen ja tarvittaessa erityissääntöjä (esim. *.sln-teksti eol=crlf).
  2. Juosta git add –renormalize. jotta Git kävisi läpi repositorion ja säätäisi rivinvaihtoja sääntöjen mukaisesti.
  3. Tee a yksittäinen commit selkeällä viestillä (esim. ”Homogenisoitu linja muuttuu”).
  4. Kerro tiimille ja kysy vetää ennen kuin ryhdytään minimoimaan konflikteja.

Jos sinulla on arkaluontoisia skriptejä (sh, py jne.), varmista, että ne on tallennettu LF- muuttujalla ja että shebang ei ole vioittunut. Voit varmistaa tämän .gitattributes-tiedoston mallien avulla tai tarkistaa sen editorissasi ennen committia.

Visual Studiossa, jos se havaitsee epäjohdonmukaisia ​​hyppyjä, se ehdottaa normalisointia. Hyväksy, tarkista eroavaisuudet ja vahvista sitten edellinen uudelleennormalisointi varmistaaksesi, että kaikki toimii oikein.

Siitä hetkestä lähtien, kun .gitattributes ja core.autocrlf oli määritetty oikein, "tällä kertaa CRLF käsitteli sen" -korjaukset olivat menneisyyttä . Ja jos joku avaa projektin Linuxissa tai macOS:ssä, kaikki pysyy samana, koska arkiston tiedostot tallennetaan LF:llä.

Microsoft Officen tukemat tiedostomuodot ja milloin niitä kannattaa käyttää
Aiheeseen liittyvä artikkeli:
Microsoft Officen tiedostomuodot: Mitä ne ovat ja milloin niitä käytetään
Isaac

Isaac

Intohimoinen kirjoittaja tavujen maailmasta ja tekniikasta yleensä. Rakastan jakaa tietämykseni kirjoittamalla, ja sen aion tehdä tässä blogissa, näyttää sinulle kaikki mielenkiintoisimmat asiat vempaimista, ohjelmistoista, laitteistoista, teknologisista trendeistä ja muusta. Tavoitteeni on auttaa sinua navigoimaan digitaalisessa maailmassa yksinkertaisella ja viihdyttävällä tavalla.