EditorConfig 테스터

사용법

1. 첫 번째 상자에 .editorconfig를 붙여넣습니다. 파일이 여러 개면 "# path: vendor/.editorconfig" 같은 표시 줄로 각각을 구분하고, 프로젝트 루트 파일을 맨 앞에 둡니다.
2. 두 번째 상자에 검사할 경로를 한 줄에 하나씩 적습니다. 최상위 .editorconfig가 있는 프로젝트 루트 기준의 상대 경로입니다.
3. 경로별 표를 읽습니다. 속성, 최종 값, 그리고 그 값을 정한 파일·줄·섹션 글롭이 나옵니다. 유도됨으로 표시된 줄은 어느 파일에도 적혀 있지 않은 값이며, 어떤 규칙에서 나왔는지 함께 표시됩니다.
4. 표 위의 탐색 경로 줄을 확인합니다. 가까운 순서로 참조한 .editorconfig 목록과, root = true가 탐색을 멈췄는지 아니면 프로젝트 위로 계속 올라가는지가 나옵니다.
5. 발견 패널을 차례로 확인합니다. 죽은 섹션, 절대 이기지 못하는 설정, 중괄호 안의 공백처럼 파일이 보이는 것과 다르게 동작하는 지점을 파일과 줄 번호로 짚어 줍니다.

자주 묻는 질문

[*]에 2라고 썼는데 왜 공백 네 칸이 되나요?

뒤에 있거나 더 가까운 설정이 이겼기 때문입니다. EditorConfig에는 CSS 같은 구체성 순위가 없습니다. 한 파일 안에서는 마지막에 일치한 섹션이 이기므로, [*] 블록 스무 줄 아래의 [*.py] 블록이 조용히 덮어씁니다. 같은 이름의 [*] 섹션이 아래에 한 번 더 나와도 마찬가지여서 섹션 이름 중복이 문제가 됩니다. 파일끼리는 속성별로 가장 가까운 .editorconfig가 이기므로, 작업 중인 디렉터리의 두 줄짜리 파일이 루트의 잘 정리된 파일을 이깁니다. 순서와 거리가 전부이며, "설정한 곳" 열이 값을 만든 파일과 줄과 섹션 글롭, 그리고 그것이 밀어낸 설정까지 보여 줍니다.

[*.js], [lib/*.js], [**/*.js]는 무엇이 다른가요?

차이는 슬래시의 유무뿐입니다. 슬래시가 없는 글롭은 깊이와 상관없이 파일 이름만 보므로 [*.js]는 src/a.js도 vendor/dist/b.js도 포함합니다. 끝이 아닌 자리에 슬래시가 하나라도 있으면 그 .editorconfig가 있는 디렉터리에 고정되어, [lib/*.js]는 lib/a.js에만 맞고 lib/sub/a.js에도 src/lib/a.js에도 맞지 않습니다. [**/*.js]는 고정되어 있으면서 디렉터리를 넘나드는 형태입니다. *는 슬래시에서 멈추지만 **는 넘어가고, 가운데의 /**/는 디렉터리가 아예 없는 경우도 뜻하므로 a.js와 lib/sub/a.js가 모두 맞습니다. 마지막 함정으로 [lib/]처럼 슬래시로 끝나는 글롭은 아무것도 맞히지 못합니다. 파일 경로는 슬래시로 끝나지 않기 때문이며, 하위 전체는 [lib/**]로 씁니다.

쓴 적 없는 indent_size = tab과 tab_width는 어디서 왔나요?

병합이 끝난 뒤 코어가 적용하는 대체 규칙에서 나옵니다. indent_style이 tab이고 indent_size가 없으면 indent_size는 tab이 됩니다. indent_size가 숫자이고 tab_width가 없으면 tab_width가 그 값을 복사하므로, indent_size만 적은 파일에서도 tab_width가 함께 보고됩니다. 반대로 indent_size가 tab이고 tab_width가 있으면 indent_size가 그 숫자를 가져옵니다. 병합 결과에 대해 동작하기 때문에 두 조각이 서로 다른 파일에서 올 수 있습니다. unset도 같은 경로를 타므로 indent_size = unset이면 tab_width까지 unset이 됩니다.

root = true는 정확히 무엇을 멈추나요?

.editorconfig를 더 찾으러 위로 올라가는 탐색을 멈춥니다. 이 줄이 없으면 탐색은 프로젝트에서 끝나지 않고 상위 디렉터리, 홈 디렉터리, 파일 시스템 루트까지 계속되며 거기서 찾은 설정이 내 파일이 정하지 않은 속성을 채웁니다. 두 가지가 중요합니다. 첫 섹션 헤더보다 위, 즉 서두에 있어야 합니다. [*] 블록 안에 쓰면 root라는 이름의 평범한 속성일 뿐이라 아무것도 멈추지 않습니다. 또한 그 파일의 섹션이 하나도 맞지 않아도 root = true는 읽히므로, 섹션이 전부 어긋난 설정 파일도 탐색을 끝냅니다.

[*.{js, ts}]가 왜 .ts 파일에 적용되지 않나요?

공백이 패턴의 일부이기 때문입니다. 중괄호 선택지는 쉼표 사이 문자열을 그대로 비교하며 섹션 헤더에서는 어떤 공백도 다듬지 않습니다. 따라서 {js, ts}가 제시하는 후보는 "js"와 " ts"이고, 이름에 실제로 공백이 들어간 파일만 두 번째 후보에 맞습니다. 비슷한 함정이 둘 더 있습니다. 쉼표가 없는 {js}는 선택지가 아니라 문자 그대로 {js} 세 글자라서 [*.{js}]는 app.{js}라는 이름의 파일에만 적용됩니다. 그리고 {1..10} 같은 숫자 범위는 앞자리 0을 거부하므로 1.txt와 10.txt는 맞지만 01.txt는 맞지 않습니다.

역슬래시로 별표를 이스케이프할 수 있나요?

설명서 문구와 달리 참조 구현에서는 되지 않습니다. 코어는 글롭을 한 번에 정규식으로 옮기는데, 이스케이프가 실제로 처리되는 문자는 쉼표, 닫는 중괄호, #, ; 뿐입니다. 이들은 그대로 두면 패턴을 끝내거나 선택지를 나누는 문자입니다. 별표나 물음표 앞의 역슬래시는 버려지고 와일드카드는 그대로 남아서 [a\*b.txt]는 aXb.txt에도 맞습니다. 더 나쁜 경우로 \[와 \{는 생성된 정규식의 괄호 짝을 깨뜨려 컴파일 자체가 실패하고, 편집기 플러그인은 대개 아무 말 없이 .editorconfig 전체를 무시합니다. 이 도구는 추측하지 않고 그대로 재현해 해당 섹션을 사용할 수 없는 글롭으로 표시합니다. 실무적인 조언은 섹션 이름에 중괄호와 대괄호, 별표를 넣지 않는 것입니다.

관련 도구