출처 대조 B · Ubuntu, Node.js 22, Prettier 3.9.9. VS Code 저장 시 동작은 실행하지 않았다

검증 환경: Ubuntu(GitHub Actions 러너), Node.js 22, Prettier 3.9.9. VS Code 저장 시 동작은 실행하지 않았다

게시 2026-10-06최종 확인 2026-10-06읽기 5분

.editorconfig·Prettier로 코드 스타일 맞추기 (VS Code 저장 시 자동 정렬)

.editorconfig로 들여쓰기 규칙을 정하고, Prettier와 VS Code 저장 시 자동 정렬(formatOnSave)을 설정하는 방법. .prettierrc와의 우선순위까지 정리한다.

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-8
end_of_line = lf
indent_style = space
indent_size = 4
insert_final_newline = true

Prettier 문서는 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)하는 것이 문서의 권장이다.

Terminal window
npm install --save-dev --save-exact prettier

3. 터미널에서 정렬·검사

Terminal window
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 형식과 키 값만 검사했다.

CI 실행 결과 · 수정 전 재현 1건 · 수정 후 8/8 단계 성공
검증 환경 5항목
OSUbuntu 24.04.5
prettier3.9.9
Node22.23.3
실행 날짜2026-10-08
작성자 기재 환경Ubuntu(GitHub Actions 러너), Node.js 22, Prettier 3.9.9. VS Code 저장 시 동작은 실행하지 않았다
실행 기록
[PASS] prettier가 설치됐다
수정 전 재현 · 예상된 실패 1건 재현됨정렬 전: 들여쓰기가 맞지 않는 파일
[XFAIL] prettier --check가 app.js를 지적한다 — 예상된 실패 재현됨 (/Code style issues found|app\.js/)
    > [warn] app.js
수정 후 확인 · 7/7 단계 성공.editorconfig(indent_size = 4)를 읽어 정렬한다
[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와 기본 포맷터가 있다
이 결과는 글의 명령어를 GitHub Actions의 깨끗한 환경에서 그대로 실행해 자동으로 붙인 것입니다.

주의

  • 사람이 확인할 단계: 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로 설정한다.

참고 자료