> **Источник:** https://python-all.ru/3.4/library/glob.html
>
> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.

---

# 11.7. [`glob`](https://python-all.ru/3.4/library/glob.html#module-glob) – расширение шаблонов путей в стиле Unix

**Исходный код:** [Lib/glob.py](https://python-all.ru/src/3.4/Lib/glob.py)

---

Модуль [`glob`](https://python-all.ru/3.4/library/glob.html#module-glob) находит все пути, соответствующие заданному шаблону, согласно правилам оболочки Unix, хотя результаты возвращаются в произвольном порядке. Подстановка тильды не выполняется, но `*`, `?` и диапазоны символов, заданные с помощью `[]`, будут правильно обработаны. Это делается с помощью совместного использования функций [`os.listdir()`](https://python-all.ru/3.4/library/os.html#os.listdir) и [`fnmatch.fnmatch()`](https://python-all.ru/3.4/library/fnmatch.html#fnmatch.fnmatch), а не вызовом подпроцесса. Обратите внимание: в отличие от [`fnmatch.fnmatch()`](https://python-all.ru/3.4/library/fnmatch.html#fnmatch.fnmatch), [`glob`](https://python-all.ru/3.4/library/glob.html#module-glob) обрабатывает имена файлов, начинающиеся с точки (`.`), как особые случаи. (Для подстановки тильды и переменных оболочки используйте [`os.path.expanduser()`](https://python-all.ru/3.4/library/os.path.html#os.path.expanduser) и [`os.path.expandvars()`](https://python-all.ru/3.4/library/os.path.html#os.path.expandvars).)

Для точного совпадения заключите метасимволы в скобки. Например, `'[?]'` соответствует символу `'?'`.

> **См. также**
>
> Модуль [`pathlib`](https://python-all.ru/3.4/library/pathlib.html#module-pathlib) предоставляет высокоуровневые объекты путей.

#### `glob.glob(pathname)`

Возвращает (возможно пустой) список путей, соответствующих *pathname*, который должен быть строкой, содержащей спецификацию пути. *pathname* может быть абсолютным (например, `/usr/src/Python-1.5/Makefile`) или относительным (например, `../../Tools/*/*.gif`) и может содержать шаблоны в стиле оболочки. Битые симлинки включаются в результаты (как в оболочке).

#### `glob.iglob(pathname)`

Возвращает [*итератор*](https://python-all.ru/3.4/glossary.html#term-iterator), который выдаёт те же значения, что и [`glob()`](https://python-all.ru/3.4/library/glob.html#module-glob), без хранения их всех одновременно.

#### `glob.escape(pathname)`

Экранирует все специальные символы (`'?'`, `'*'` и `'['`). Это полезно, если нужно сопоставить произвольную литеральную строку, которая может содержать специальные символы. Специальные символы в дисках/UNC-точках монтирования не экранируются, например, в Windows `escape('//?/c:/Quo vadis?.txt')` возвращает `'//?/c:/Quo vadis[?].txt'`.

Новое в версии 3.4.

Например, рассмотрим каталог, содержащий только следующие файлы: `1.gif`, `2.txt` и `card.gif`. [`glob()`](https://python-all.ru/3.4/library/glob.html#module-glob) выдаст следующие результаты. Обратите внимание, что начальные компоненты пути сохраняются.

```python
>>> import glob
>>> glob.glob('./[0-9].*')
['./1.gif', './2.txt']
>>> glob.glob('*.gif')
['1.gif', 'card.gif']
>>> glob.glob('?.gif')
['1.gif']
```

Если каталог содержит файлы, начинающиеся с `.`, они не будут сопоставлены по умолчанию. Например, рассмотрим каталог, содержащий `card.gif` и `.card.gif`:

```python
>>> import glob
>>> glob.glob('*.gif')
['card.gif']
>>> glob.glob('.c*')
['.card.gif']
```

> **См. также**
>
> **Модуль [`fnmatch`](https://python-all.ru/3.4/library/fnmatch.html#module-fnmatch)**
>
> Расширение имен файлов (не путей) в стиле оболочки