Provador de patrons glob
Patrons glob
Rutes
Resultats
Xuleta de sintaxi
- *
- Qualsevol caràcter dins d'un segment de ruta (no coincideix amb /)
- **
- Qualsevol nombre de segments de ruta, fins i tot cap
- ?
- Exactament un caràcter (no /)
- [abc]
- Un caràcter del conjunt; [a-z] per a un rang, [!abc] per negar
- {a,b}
- Alternatives, p. ex. *.{ts,tsx}, o rangs com {1..3}
- !(x)
- Qualsevol cosa excepte les alternatives indicades, p. ex. !(*.test).ts
- +(x)
- Una o més de les alternatives indicades, p. ex. +(a|b)
- @(x)
- Exactament una de les alternatives indicades, p. ex. @(js|ts)
Detalls tècnics
Com funciona el provador de patrons glob
Què fa l'eina
El provador de patrons glob comprova un o més patrons glob contra una llista de rutes de fitxer i marca cada ruta com a coincident o no coincident. Els patrons s'avaluen en ordre, a l'estil gitignore: un patró que comença per ! treu rutes del resultat i els patrons posteriors anul·len els anteriors. Cada resultat mostra quin patró ha pres la decisió final, i pots inspeccionar l'expressió regular que picomatch compila per a cada patró. Tot s'executa al navegador.
Casos d'ús habituals per a desenvolupadors
Els desenvolupadors fan servir provadors de glob per depurar les llistes d'inclusió i exclusió de tsconfig.json, els fitxers ignore d'ESLint i Prettier, els patrons de proves de Jest i Vitest, els filtres de ruta de GitHub Actions, la configuració de bundlers i les claus de memòria cau de CI. També és útil per comprovar les regles de .gitignore i .dockerignore abans de fer commit, i per entendre per què una eina de compilació inclou, o omet en silenci, un fitxer concret.
Formats de dades, tipus o variants
El mode predeterminat utilitza picomatch, el motor de coincidència que hi ha darrere de micromatch i de moltes eines de compilació, amb suport per als comodins * i **, ? per a un sol caràcter, classes de caràcters [abc], alternatives amb claus {a,b} i extglobs com !(x), +(x) i @(x). El mode opcional .gitignore afegeix les regles de gitignore: els patrons sense barra coincideixen a qualsevol profunditat, una barra inicial ancora a l'arrel i una barra final només coincideix amb directoris. Els fitxers .gitignore dels subdirectoris i la regla que un fitxer no es pot tornar a incloure si el seu directori pare està exclòs no es modelen.
Errors comuns i bones pràctiques
Els comodins no coincideixen amb fitxers que comencen per punt, tret que l'opció dot estigui activada o el punt s'escrigui explícitament, així que **/* omet .github i .env. * mai no travessa una barra, de manera que *.ts només coincideix amb fitxers del nivell superior; fes servir **/*.ts per a qualsevol profunditat. L'ordre importa amb la negació: un patró ! només exclou les rutes que han coincidit amb un patró anterior. La coincidència glob distingeix majúscules de minúscules de manera predeterminada, i les diferents eines (minimatch, micromatch, el globbing del shell, .gitignore) tenen diferències subtils, així que confirma els resultats a l'eina amb la qual realment desplegues.