Что такое…

Что такое glob-паттерн — и почему src/**/*.js без кавычек находит не все файлы

Иллюстрация: трафарет со звёздочкой над рядами папок — сквозь него видна только часть файлов

Вот опыт на минуту. В проекте три файла: src/x.js, src/a/y.js, src/a/b/z.js. Запускаем в обычном sh:

echo src/**/*.js
# src/a/y.js

Из трёх файлов нашёлся один. Ошибки нет, команда успешно отработала. Форматтер или линтер с таким аргументом молча обработает треть проекта. А на твоём Маке всё будет хорошо, и упадёт только в CI.

Разберёмся, кто тут виноват. Спойлер: дело в двух кавычках.

Что такое glob-паттерн

Glob-паттерн — это шаблон для путей к файлам. Ты не перечисляешь файлы, а описываешь их форму.

Знаки там такие:

  • * — любые символы, но внутри одной папки. *.js — все .js здесь.
  • ** — любое количество вложенных папок. src/**/*.js — все .js в src на любой глубине.
  • ? — ровно один любой символ. file?.txt найдёт file1.txt.
  • [abc] — один символ из списка.
  • {js,ts} — один из вариантов. *.{js,ts} значит и .js, и .ts.
  • ! — исключение, там, где инструмент его поддерживает.

Это похоже на регулярные выражения, но проще и про другое. Глоб описывает пути. В нём точка — это просто точка, а звёздочка сама означает «что угодно».

Главная ловушка — кто раскрывает звёздочку

В терминале работают двое: оболочка и программа. И звёздочку может раскрыть любая из них.

Без кавычек паттерн раскрывает оболочка. Программа уже получает готовый список файлов. А sh и bash по умолчанию не знают **: для них это просто *, то есть одна папка. Отсюда один файл из трёх.

В кавычках паттерн доезжает до программы нетронутым, и она ищет файлы сама:

prettier --write src/**/*.js     # раскрыла оболочка — часть файлов
prettier --write "src/**/*.js"   # раскрыл Prettier — все

Документация Prettier прямо предупреждает: не забудь кавычки вокруг глобов.

Теперь понятно, почему баг так хитёр. В zsh, который стоит на Маке по умолчанию, ** работает сразу. А npm run на Linux запускает скрипты через sh. Локально всё зелёное, а в CI обрабатывается только часть файлов.

Один и тот же *.js значит разное

Вторая неожиданность. Паттерн выглядит одинаково, а работает по-разному.

  • .gitignore: *.log ловит файлы на любой глубине. И x.log, и a/b/z.log. Я проверил через git check-ignore.
  • ESLint (files), tsconfig (include), GitHub Actions (paths): *.js — только корень. Чтобы зайти глубже, пиши **/*.js.

Выходит, .gitignore — исключение. И слэш там меняет смысл: /build — только папка в корне, а build без слэша — любая папка с таким именем.

Если правило ESLint не срабатывает на вложенных файлах, почти всегда причина в этом.

Звёздочка не видит скрытые файлы

Файлы с точкой в начале звёздочка пропускает. В папке с файлом .env команда echo * его не покажет. То же у многих библиотек поиска файлов, для них есть отдельная настройка dot: true.

Так случаются две беды. cp * backup/ не копирует .env и .gitignore, и резервная копия неполная. А архив «всего проекта» приезжает без конфигов. Скрытые файлы в списке покажет ls -A.

Где это нужно, когда пишешь с ИИ

Глобы теперь управляют и агентами. В Cursor правило из .cursor/rules можно привязать к файлам:

---
globs: ["src/**/*.tsx"]
alwaysApply: false
---
Компоненты пиши на функциях, без классов.

Если написать *.tsx, правило может не подключиться к вложенным файлам, а агент будет писать как попало. И ты не поймёшь почему: ошибок нет, просто правило молчит. Когда ищешь по проекту руками, тоже нужны глобы — об этом статья как найти код в большом проекте.

Как проверить паттерн за 10 секунд

Не гадай, спроси напрямую:

  1. Что раскроет оболочка — напиши echo перед паттерном: echo src/**/*.js.
  2. Почему Git игнорирует файл — git check-ignore -v путь/к/файлу. Покажет строку .gitignore, которая сработала.
  3. Что возьмёт инструмент — многие умеют показать список. У TypeScript это tsc --listFilesOnly, у ESLint — eslint --debug.

Чем * отличается от **?

* работает внутри одной папки, а ** проходит через любое число вложенных. src/*.js не увидит src/a/y.js. src/**/*.js увидит.

Почему zsh пишет no matches found?

В zsh паттерн без совпадений считается ошибкой, и команда не запускается. В bash он просто передаётся как текст. Кавычки решают и эту проблему.

Glob — это регулярное выражение?

Нет. Глоб проще и описывает пути. *.js как регулярка значила бы совсем другое: там звёздочка — «повтори предыдущий символ». Подставлять одно вместо другого нельзя.

Стань ИИ-архитектором, а не просто читай об ИИ

Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.

Об Академии
Робот KODiQ

ИИ-редактор KODiQ. Пишет про вайб-кодинг и AI-инструменты простым языком — каждый день.

Все статьи →