آزمونگر الگوی 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 برای اشکالزدایی فهرستهای include و exclude در tsconfig.json، فایلهای ignore مربوط به ESLint و Prettier، الگوهای آزمون Jest و Vitest، فیلترهای مسیر در GitHub Actions، پیکربندی bundler و کلیدهای کش CI استفاده میکنند. همچنین برای بررسی قوانین .gitignore و .dockerignore پیش از commit و فهمیدن اینکه چرا یک ابزار بیلد فایلی مشخص را برمیدارد یا بیصدا نادیده میگیرد مفید است.
فرمتهای داده، انواع یا گونهها
حالت پیشفرض از picomatch استفاده میکند، تطبیقدهندهای که پشت micromatch و بسیاری از ابزارهای بیلد قرار دارد، و از نویسههای عام * و **، ? برای یک نویسه، کلاسهای نویسه [abc]، گزینههای آکولادی {a,b} و extglobهایی مانند !(x)، +(x) و @(x) پشتیبانی میکند. حالت اختیاری .gitignore قوانین gitignore را اضافه میکند: الگوهای بدون اسلش در هر عمقی تطبیق مییابند، اسلش ابتدایی الگو را به ریشه قفل میکند و اسلش انتهایی فقط با پوشهها تطبیق مییابد. فایلهای .gitignore در زیرپوشهها و این قانون که اگر پوشه والد فایل مستثنا شده باشد فایل را نمیتوان دوباره شامل کرد، مدلسازی نشدهاند.
نکات احتیاطی رایج و بهترین روشها
نویسههای عام با فایلهای نقطهدار تطبیق نمییابند مگر اینکه گزینه dot روشن باشد یا نقطه صریحاً نوشته شود، بنابراین **/* پوشههای .github و .env را رد میکند. * هرگز از اسلش عبور نمیکند، پس *.ts فقط با فایلهای سطح بالا تطبیق مییابد؛ برای هر عمقی از **/*.ts استفاده کنید. در نفی، ترتیب اهمیت دارد: الگوی ! فقط مسیرهایی را مستثنا میکند که الگوی قبلی با آنها تطبیق یافته است. تطبیق glob بهطور پیشفرض به حروف بزرگ و کوچک حساس است و ابزارهای مختلف (minimatch، micromatch، glob کردن در shell، .gitignore) تفاوتهای ظریفی دارند، پس نتایج را در ابزاری که واقعاً با آن دیپلوی میکنید تأیید کنید.