Windows와 macOS에서 함께 개발할 때 캐리지 리턴 설정

1. 줄바꿈(Line Ending) 문제 이해

• Windows: CRLF (\r\n)
• macOS (및 Unix/Linux): LF (\n)

윈도우와 맥에서 동일한 프로젝트를 개발할 때, 서로 다른 줄바꿈 문자 때문에 Git에서 불필요한 변경이 발생하거나, 특정 파일이 깨질 수 있습니다.

---

2. Git에서 줄바꿈 통일하기

(1) .gitattributes 파일 설정

저장소 루트에 .gitattributes 파일을 만들고 다음 내용을 추가하세요:

# 텍스트 파일의 줄바꿈을 LF로 강제
* text=auto eol=lf

 

이 설정을 하면:

• Git은 체크아웃할 때 OS에 맞는 줄바꿈을 적용
• 커밋할 때는 자동으로 LF로 변환

만약 줄바꿈을 강제하려면:

* text eol=lf

 

이렇게 하면 모든 텍스트 파일이 강제로 LF로 저장됩니다.

---

(2) 개별 사용자 Git 설정 변경

각 개발자는 로컬 Git 설정에서 줄바꿈을 자동 변환하도록 설정할 수 있습니다.

윈도우 사용자의 설정

git config --global core.autocrlf true

 

• 체크아웃 시 CRLF로 변환
• 커밋할 때는 LF로 변환

맥 사용자의 설정

git config --global core.autocrlf input

 

• 커밋할 때만 LF 유지 (CRLF로 변경하지 않음)

---

3. VS Code 설정

VS Code에서는 LF를 강제할 수 있습니다.

1. 파일 > 기본 설정 > 설정 (Settings)
2. 검색창에 end of line 입력
3. "Files: Eol" 옵션을 LF로 변경

또는, settings.json에 다음을 추가:

{
    "files.eol": "\n"
}

 

---

4. 기존 파일 줄바꿈 변경

이미 CRLF로 저장된 파일을 LF로 일괄 변경하려면:

find . -type f -exec dos2unix {} +

 

또는, VS Code에서 Ctrl + Shift + P → Change End of Line Sequence → LF 선택 후 저장.

---

이제 윈도우와 맥에서 동일한 줄바꿈을 유지하면서 개발할 수 있습니다! 🚀