7강. EditorConfig와 공통 규칙: 팀원마다 들여쓰기가 달라지지 않게 하기

?1. 이번 강의에서 해결할 문제

Windows와 다른 운영체제, 여러 IDE가 같은 파일의 줄 끝과 들여쓰기를 계속 바꿉니다. Formatter보다 아래 단계의 공통 편집 규칙을 정합니다.

✓2. 학습 목표

✓이 강의를 마치면

• EditorConfig와 Formatter의 적용 범위를 구분합니다.
• 파일 유형별 들여쓰기와 줄 끝 규칙을 작성합니다.
• 기존 프로젝트 규칙과 충돌 여부를 확인합니다.

◇3. 핵심 개념

EditorConfig는 프로젝트 루트부터 파일 경로에 맞는 기본 편집 규칙을 제공합니다. root = true는 상위 폴더 검색을 멈춥니다. 지원 키와 의미는 EditorConfig 공식 사양을 확인합니다.

✎4. 단계별 실습

INI · 파일 경로: 프로젝트 루트 .editorconfig

.editorconfig

root = true

[*]
charset = utf-8
end_of_line = lf
insert_final_newline = true
trim_trailing_whitespace = true

[*.{js,jsx,ts,tsx,json,css,md}]
indent_style = space
indent_size = 2

[*.{py,java,cs}]
indent_style = space
indent_size = 4

[*.md]
trim_trailing_whitespace = false

PowerShell · 실행 위치: 프로젝트 루트

Get-Content .\.editorconfig
git diff --check

예상 결과: 공통 규칙이 출력되고 줄 끝 공백 문제가 있으면 diff 검사에 표시됩니다. 관리자 권한은 필요하지 않습니다.

macOS·Linux 차이

세 운영체제 모두 EditorConfig를 사용할 수 있지만 파일 시스템 대소문자 처리와 기본 줄 끝이 다를 수 있습니다. 저장소 규칙을 적용한 뒤 실제 빌드·테스트로 확인하세요.

→5. 도구와 설정이 동작하는 이유

EditorConfig를 지원하는 에디터는 현재 파일 경로와 가장 가까운 설정을 읽어 저장 동작에 적용합니다. Markdown의 의미 있는 줄 끝 공백처럼 예외가 필요한 파일은 더 구체적인 섹션에서 덮어씁니다.

!6. 자주 하는 실수와 해결법

!자주 하는 실수

• 기존 저장소에 즉시 전체 적용: 먼저 규칙만 추가하고 기능 변경과 대량 포맷을 분리합니다.
• 모든 언어 들여쓰기를 하나로 강제: 언어·기존 프로젝트 기준에 맞는 섹션을 둡니다.
• EditorConfig가 코드 스타일 전부를 처리한다고 생각: 구문 배치는 Formatter가 담당합니다.
• 줄 끝 변경과 기능 수정을 같은 커밋에 섞음: 리뷰 가능한 작은 변경으로 나눕니다.

✎7. 직접 실습

✎직접 실습

현재 프로젝트의 주 언어와 문서에 맞게 위 설정을 최소 수정하세요. 기존 파일 하나를 저장하고 diff가 들여쓰기·줄 끝만 바꿨는지 확인합니다.

?8. 이해 점검 질문 3개

?이해 점검

1. root = true는 어떤 검색을 멈추나요?
2. Markdown에 trim 예외를 둘 수 있는 이유는 무엇인가요?
3. EditorConfig와 Formatter의 책임은 어떻게 다른가요?

■9. 핵심 요약

■핵심 요약

EditorConfig는 IDE와 운영체제를 넘어 인코딩, 줄 끝과 들여쓰기 기본값을 공유합니다. 기존 규칙을 확인하고 대량 변경은 기능 수정과 분리합니다.