Glob-kuvioiden testaaja
Glob-kuviot
Polut
Tulokset
Syntaksin pikaopas
- *
- Mitkä tahansa merkit yhden polkusegmentin sisällä (ei täsmää /-merkkiin)
- **
- Mikä tahansa määrä polkusegmenttejä, myös nolla
- ?
- Täsmälleen yksi merkki (ei /)
- [abc]
- Yksi joukon merkeistä; [a-z] välille, [!abc] kieltoon
- {a,b}
- Vaihtoehdot, esim. *.{ts,tsx}, tai välit kuten {1..3}
- !(x)
- Mikä tahansa paitsi luetellut vaihtoehdot, esim. !(*.test).ts
- +(x)
- Yksi tai useampi luetelluista vaihtoehdoista, esim. +(a|b)
- @(x)
- Täsmälleen yksi luetelluista vaihtoehdoista, esim. @(js|ts)
Tekniset tiedot
Näin glob-kuvioiden testaaja toimii
Mitä työkalu tekee
Glob-kuvioiden testaaja tarkistaa yhden tai useamman glob-kuvion tiedostopolkuluetteloa vasten ja merkitsee jokaisen polun täsmääväksi tai ei-täsmääväksi. Kuviot arvioidaan järjestyksessä gitignore-tyylisesti: !-merkillä alkava kuvio poistaa polkuja tuloksesta, ja myöhemmät kuviot ohittavat aiemmat. Jokainen tulos näyttää, mikä kuvio teki lopullisen päätöksen, ja voit tarkastella säännöllistä lauseketta, jonka picomatch kääntää jokaisesta kuviosta. Kaikki toimii selaimessasi.
Yleisiä kehittäjien käyttötapauksia
Kehittäjät käyttävät glob-testaajia sisällytys- ja poissulkemisluetteloiden vianetsintään tiedostoissa tsconfig.json, ESLintin ja Prettierin ignore-tiedostoissa, Jestin ja Vitestin testikuvioissa, GitHub Actionsin polkusuodattimissa, bundlerin asetuksissa ja CI-välimuistin avaimissa. Se on hyödyllinen myös .gitignore- ja .dockerignore-sääntöjen tarkistamiseen ennen commitointia ja sen ymmärtämiseen, miksi koontityökalu ottaa mukaan tai ohittaa hiljaa tietyn tiedoston.
Tietomuodot, tyypit tai variantit
Oletustila käyttää picomatchia, eli micromatchin ja monien koontityökalujen taustalla olevaa vertailijaa, ja tukee jokerimerkkejä * ja **, yksittäistä merkkiä ?, merkkiluokkia [abc], aaltosulkeilla kirjoitettuja vaihtoehtoja {a,b} sekä extglobeja, kuten !(x), +(x) ja @(x). Valinnainen .gitignore-tila lisää gitignore-säännöt: kauttaviivattomat kuviot täsmäävät millä tahansa syvyydellä, alussa oleva kauttaviiva ankkuroi juureen ja lopussa oleva kauttaviiva täsmää vain hakemistoihin. Alihakemistojen .gitignore-tiedostoja ja sääntöä, jonka mukaan tiedostoa ei voi ottaa takaisin mukaan, jos sen ylähakemisto on poissuljettu, ei ole mallinnettu.
Yleisiä sudenkuoppia ja parhaita käytäntöjä
Jokerimerkit eivät täsmää pistetiedostoihin, ellei dot-asetus ole päällä tai piste ole kirjoitettu eksplisiittisesti, joten **/* ohittaa .github- ja .env-tiedostot. * ei koskaan ylitä kauttaviivaa, joten *.ts täsmää vain ylätason tiedostoihin; käytä **/*.ts mille tahansa syvyydelle. Järjestyksellä on väliä kiellossa: !-kuvio poissulkee vain polut, jotka aiempi kuvio on täsmännyt. Glob-vertailu on oletuksena kirjainkoosta riippuvainen, ja eri työkaluilla (minimatch, micromatch, komentotulkin globbaus, .gitignore) on hienovaraisia eroja, joten varmista tulokset työkalussa, jolla todella julkaiset.