30초 요약
- 프로젝트에
.editorconfig를 두면 Prettier가 이를 읽어 자신의 설정으로 변환한다. 문서 기준으로indent_size는tabWidth,end_of_line은endOfLine에 대응한다. .prettierrc같은 Prettier 설정 파일이 있으면 그쪽이.editorconfig보다 우선한다.- 설치는
npm install --save-dev --save-exact prettier, 전체 정렬은npx prettier . --write, CI 검사는npx prettier . --check다. - VS Code에서는
esbenp.prettier-vscode확장을 기본 포맷터로 지정하고editor.formatOnSave를 켠다.
목표
팀원마다 에디터 설정이 달라 들여쓰기와 줄 끝 문자가 뒤섞이는 상황을 막는다. 에디터 공통 규칙은 .editorconfig에, 포맷 실행은 Prettier에 맡기고, 저장할 때 자동으로 정렬되게 한다.
원인
들여쓰기·줄 끝 문자 같은 규칙이 파일로 정해져 있지 않으면 각자의 에디터 기본값이 쓰인다. 규칙을 저장소에 두면 같은 설정을 모두가 따른다.
해결 방법
1. .editorconfig 만들기
프로젝트 루트에 .editorconfig를 만든다.
root = true
[*]charset = utf-8end_of_line = lfindent_style = spaceindent_size = 4insert_final_newline = truePrettier 문서는 end_of_line, indent_style, indent_size, max_line_length를 Prettier 설정으로 바뀌는 항목으로, charset = utf-8과 insert_final_newline = true는 설정과 상관없이 Prettier가 늘 그렇게 동작하는 항목으로 나눈다. 옵션 문서 기준으로 indent_size는 tabWidth, indent_style은 useTabs, max_line_length는 printWidth, end_of_line은 endOfLine을 정한다. 문서는 EditorConfig 명세와 달리 .editorconfig 검색이 프로젝트 루트에서 멈추고 그 위로 올라가지 않는다고 적는다.
2. Prettier 설치
공식 설치 안내를 따른다. 팀 전체가 같은 결과를 얻도록 버전을 고정(--save-exact)하는 것이 문서의 권장이다.
npm install --save-dev --save-exact prettier3. 터미널에서 정렬·검사
npx prettier . --write # 전체 정렬npx prettier . --check # 정렬 여부만 검사 (CI용)--check는 파일을 고치지 않고 이미 정렬됐는지만 확인한다. 정렬하지 않을 폴더는 .prettierignore에 적는다(문서 예: build, coverage).
4. 우선순위: .prettierrc가 이긴다
Prettier 문서는 .editorconfig 설정이 .prettierrc 등 Prettier 설정 파일에 덮어쓰인다고 적는다. 같은 항목을 양쪽에 적었다면 .prettierrc가 적용된다. Prettier 설치 문서와 VS Code 확장 README는 모두 프로젝트에 Prettier 설정 파일을 두기를 권한다. README는 그 파일에 프로젝트의 모든 설정을 적어 두라고 하고, 그래야 확장·CLI·다른 에디터 어디서 실행해도 같은 설정이 적용된다고 설명한다.
5. VS Code 저장 시 자동 정렬
esbenp.prettier-vscode 확장을 설치한 뒤, 프로젝트의 .vscode/settings.json에 다음을 둔다.
{ "editor.defaultFormatter": "esbenp.prettier-vscode", "editor.formatOnSave": true}확장에는 prettier.useEditorConfig(기본값 true) 설정이 있어 .editorconfig를 반영한다. 언어별로만 켜려면 "[javascript]": { ... }처럼 언어 블록 안에 같은 키를 쓴다.
줄 끝(CRLF·LF)을 Git 쪽에서 맞추는 설정은 Git 전역 설정의 autocrlf 절에 있다.
확인
작은 예제로 확인했다. 들여쓰기가 어긋난 app.js와 위 .editorconfig(indent_size = 4)를 두고 prettier --check, --write를 차례로 실행했다. .prettierrc에 tabWidth: 3을 두면 .editorconfig의 indent_size = 4를 제치고 3칸이 되는지도 확인했다(기본값 2와도 다른 값으로 봤다).
검증 범위: Prettier의
.editorconfig반영과.prettierrc우선순위,--check·--write는 러너에서 실행으로 확인했다. VS Code 확장의 저장 시 동작은 GUI라 실행하지 못했고(문서 대조, B), settings.json은 JSON 형식과 키 값만 검사했다.
검증 환경 5항목
| OS | Ubuntu 24.04.5 |
|---|---|
| prettier | 3.9.9 |
| Node | 22.23.3 |
| 실행 날짜 | 2026-10-08 |
| 작성자 기재 환경 | Ubuntu(GitHub Actions 러너), Node.js 22, Prettier 3.9.9. VS Code 저장 시 동작은 실행하지 않았다 |
[PASS] prettier가 설치됐다
[XFAIL] prettier --check가 app.js를 지적한다 — 예상된 실패 재현됨 (/Code style issues found|app\.js/)
> [warn] app.js[PASS] prettier --write 실행 [PASS] if 블록 안이 공백 4칸으로 들여쓰기됐다 [PASS] return 1이 공백 8칸으로 들여쓰기됐다 [PASS] prettier --check 통과 [PASS] .prettierrc(tabWidth 3)가 .editorconfig(indent_size 4)를 이겨 공백 3칸으로 정렬된다 [PASS] settings.json이 올바른 JSON이다 [PASS] settings.json에 formatOnSave와 기본 포맷터가 있다
주의
- 사람이 확인할 단계: VS Code에서 파일을 저장했을 때 실제로 정렬되는지는 직접 열어 확인해야 한다.
.editorconfig와.prettierrc에 서로 다른 값을 쓰면.prettierrc가 적용된다.- VS Code에서 신뢰하지 않은 작업 공간이면 확장의
prettier.useEditorConfig가 항상 꺼진다(README). 저장해도.editorconfig가 반영되지 않으면 작업 공간을 신뢰했는지 확인한다. - Prettier는 같은 버전이어야 결과가 같다고 문서가 설명한다.
--save-exact로 버전을 고정한다.
자주 묻는 질문
Prettier가 .editorconfig를 읽나요?
읽는다. 문서에 따르면 프로젝트에 .editorconfig가 있으면 Prettier가 이를 파싱해 대응하는 Prettier 설정으로 바꾼다. 다만 검색은 프로젝트 루트에서 멈춘다.
.editorconfig와 .prettierrc가 충돌하면 어느 쪽이 적용되나요?
.prettierrc 등 Prettier 설정 파일이 우선한다. .editorconfig 설정은 그 파일들에 덮어쓰인다.
VS Code에서 저장할 때 자동으로 정렬하려면 어떻게 하나요?
editor.defaultFormatter를 esbenp.prettier-vscode로 지정하고 editor.formatOnSave를 true로 설정한다.