Glob 패턴 테스터
Glob 패턴
경로
결과
구문 치트시트
- *
- 하나의 경로 세그먼트 안의 모든 문자(/는 일치하지 않음)
- **
- 없는 경우를 포함한 임의의 개수의 경로 세그먼트
- ?
- 정확히 한 문자(/ 제외)
- [abc]
- 집합 중 한 문자. 범위는 [a-z], 부정은 [!abc]
- {a,b}
- 대안 예: *.{ts,tsx}, 또는 {1..3} 같은 범위
- !(x)
- 나열된 대안을 제외한 모든 것. 예: !(*.test).ts
- +(x)
- 나열된 대안 중 하나 이상. 예: +(a|b)
- @(x)
- 나열된 대안 중 정확히 하나. 예: @(js|ts)
기술적 세부 정보
Glob 패턴 테스터 작동 방식
이 도구가 하는 일
Glob 패턴 테스터는 하나 이상의 glob 패턴을 파일 경로 목록에 대해 검사하고 각 경로를 일치 또는 불일치로 표시합니다. 패턴은 gitignore 방식으로 순서대로 평가됩니다. !로 시작하는 패턴은 결과에서 경로를 제거하고, 뒤에 오는 패턴이 앞의 패턴을 덮어씁니다. 각 결과에는 최종 결정을 내린 패턴이 표시되며, picomatch가 각 패턴에서 컴파일한 정규식도 확인할 수 있습니다. 모든 것이 브라우저에서 실행됩니다.
개발자의 일반적인 사용 사례
개발자는 glob 테스터를 사용해 tsconfig.json, ESLint와 Prettier의 ignore 파일, Jest와 Vitest의 테스트 패턴, GitHub Actions의 경로 필터, 번들러 설정, CI 캐시 키에 있는 include 및 exclude 목록을 디버깅합니다. 커밋하기 전에 .gitignore와 .dockerignore 규칙을 확인하거나 빌드 도구가 특정 파일을 포함하거나 조용히 건너뛰는 이유를 이해하는 데도 유용합니다.
데이터 형식, 유형 또는 변형
기본 모드는 micromatch와 많은 빌드 도구의 기반이 되는 매처인 picomatch를 사용하며, * 및 ** 와일드카드, 한 문자를 뜻하는 ?, [abc] 문자 클래스, {a,b} 중괄호 대안, !(x), +(x), @(x) 같은 extglob을 지원합니다. 선택 사항인 .gitignore 모드는 gitignore 규칙을 추가합니다. 슬래시가 없는 패턴은 모든 깊이에서 일치하고, 앞의 슬래시는 루트에 고정되며, 뒤의 슬래시는 디렉터리에만 일치합니다. 하위 디렉터리의 .gitignore 파일과 상위 디렉터리가 제외되면 파일을 다시 포함할 수 없다는 규칙은 모델링되지 않습니다.
흔한 함정과 모범 사례
와일드카드는 dot 옵션이 켜져 있거나 점이 명시적으로 쓰여 있지 않으면 점 파일과 일치하지 않으므로 **/*는 .github와 .env를 건너뜁니다. *는 슬래시를 넘지 않으므로 *.ts는 최상위 파일에만 일치하며, 모든 깊이에는 **/*.ts를 사용하세요. 부정에서는 순서가 중요합니다. ! 패턴은 앞선 패턴이 일치시킨 경로만 제외합니다. Glob 매칭은 기본적으로 대소문자를 구분하며 도구(minimatch, micromatch, 셸 글로빙, .gitignore)마다 미묘한 차이가 있으므로 실제로 배포에 사용하는 도구에서 결과를 확인하세요.