Что такое 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 секунд
Не гадай, спроси напрямую:
- Что раскроет оболочка — напиши
echoперед паттерном:echo src/**/*.js. - Почему Git игнорирует файл —
git check-ignore -v путь/к/файлу. Покажет строку.gitignore, которая сработала. - Что возьмёт инструмент — многие умеют показать список. У TypeScript это
tsc --listFilesOnly, у ESLint —eslint --debug.
Чем * отличается от **?
* работает внутри одной папки, а ** проходит через любое число вложенных. src/*.js не увидит src/a/y.js. src/**/*.js увидит.
Почему zsh пишет no matches found?
В zsh паттерн без совпадений считается ошибкой, и команда не запускается. В bash он просто передаётся как текст. Кавычки решают и эту проблему.
Glob — это регулярное выражение?
Нет. Глоб проще и описывает пути. *.js как регулярка значила бы совсем другое: там звёздочка — «повтори предыдущий символ». Подставлять одно вместо другого нельзя.
Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.





