Git line endings — Mac/Linux와 Windows 사이 CRLF 지옥 끝내기

# Default — 모든 텍스트 파일은 LF로 저장, 텍스트인지 자동 판별
* text=auto eol=lf
 
# 명시적 텍스트 — LF 강제
*.c          text eol=lf
*.cc         text eol=lf
*.cpp        text eol=lf
*.h          text eol=lf
*.hpp        text eol=lf
*.cs         text eol=lf
*.go         text eol=lf
*.java       text eol=lf
*.kt         text eol=lf
*.py         text eol=lf
*.rb         text eol=lf
*.rs         text eol=lf
*.swift      text eol=lf
*.ts         text eol=lf
*.tsx        text eol=lf
*.js         text eol=lf
*.jsx        text eol=lf
*.mjs        text eol=lf
*.cjs        text eol=lf
*.json       text eol=lf
*.jsonc      text eol=lf
*.yml        text eol=lf
*.yaml       text eol=lf
*.toml       text eol=lf
*.md         text eol=lf
*.mdx        text eol=lf
*.txt        text eol=lf
*.html       text eol=lf
*.css        text eol=lf
*.scss       text eol=lf
*.svg        text eol=lf
*.xml        text eol=lf
*.sql        text eol=lf
 
# 셸 스크립트 — LF (CRLF면 깨진다)
*.sh         text eol=lf
*.bash       text eol=lf
*.zsh        text eol=lf
*.fish       text eol=lf
Dockerfile*  text eol=lf
Makefile*    text eol=lf
 
# Windows 전용 — CRLF
*.bat        text eol=crlf
*.cmd        text eol=crlf
*.ps1        text eol=crlf
*.psm1       text eol=crlf
 
# 바이너리 — 변환 안 함
*.png        binary
*.jpg        binary
*.jpeg       binary
*.gif        binary
*.ico        binary
*.webp       binary
*.avif       binary
*.pdf        binary
*.zip        binary
*.gz         binary
*.tar        binary
*.7z         binary
*.exe        binary
*.dll        binary
*.so         binary
*.dylib      binary
*.woff       binary
*.woff2      binary
*.ttf        binary
*.otf        binary
*.mp3        binary
*.mp4        binary
*.mov        binary
 
# 노이즈 줄이기 — 어차피 텍스트지만 diff가 무의미한 파일
*.lock       text eol=lf -diff
pnpm-lock.yaml text eol=lf -diff
package-lock.json text eol=lf -diff
yarn.lock    text eol=lf -diff
Cargo.lock   text eol=lf -diff

# 저장소 root에서
git add .gitattributes
git commit -m "feat: add .gitattributes baseline"
 
# 모든 파일을 .gitattributes 규칙에 맞춰 재정렬
git add --renormalize .
git status   # 어떤 파일이 바뀌었는지 확인
git commit -m "chore: renormalize line endings"

# macOS / Linux
git config --global core.autocrlf input
# 체크아웃 시 변환 안 함, 커밋 시 CRLF → LF
 
# Windows
git config --global core.autocrlf input
# Windows에서도 input 권장 — 본인이 만든 파일은 LF로 커밋. 다른 사람이 CRLF로 만들었어도 LF로 정규화.
 
# 또는 .gitattributes만 신뢰
git config --global core.autocrlf false

git config --global core.eol lf

{
  "files.eol": "\n",
  "files.insertFinalNewline": true,
  "files.trimTrailingWhitespace": true
}

" ~/.vimrc
set fileformats=unix,dos
set fileformat=unix

# macOS/Linux
file scripts/build.sh
# ASCII text  ← OK
file scripts/build.sh | grep -q CRLF && echo CRLF 있음
 
# 또는
od -c scripts/build.sh | head -3
# 각 줄 끝에 \n 만 보여야 함. \r \n 같이 보이면 CRLF.

# CRLF가 섞인 파일 찾기
git grep --cached -lI $'\r' -- ':!*.bat' ':!*.cmd' ':!*.ps1'

- name: Check no CRLF in LF files
  run: |
    crlf=$(git grep --cached -lI $'\r' -- ':!*.bat' ':!*.cmd' ':!*.ps1' || true)
    if [ -n "$crlf" ]; then
      echo "CRLF found in LF-expected files:"
      echo "$crlf"
      exit 1
    fi

# 빠른 수동 변환
dos2unix scripts/build.sh
# 또는
sed -i 's/\r$//' scripts/build.sh

sed -i '1s/^\xEF\xBB\xBF//' file.py

# .editorconfig (저장소 root)
root = true
 
[*]
end_of_line = lf
charset = utf-8
indent_style = space
indent_size = 2
insert_final_newline = true
trim_trailing_whitespace = true
 
[*.{bat,cmd,ps1}]
end_of_line = crlf

$content | Out-File "file.txt" -Encoding utf8 -NoNewline
# 또는 PowerShell 7+
$content | Out-File "file.txt" -Encoding utf8NoBOM