Справочник по функциям Python

os.listdir

Получает имена файлов и каталогов внутри каталога.

Python 3.13
os.listdir(path='.')
  • =значение по умолчанию
path
Путь к каталогу; по умолчанию текущий.
str | PathLikeНеобязательный

Возвращаемое значение

Список имён без пути к каталогу; порядок не гарантирован.

Примеры

Список файлов в каталоге

Python 3.13
import os
os.makedirs('demo', exist_ok=True)
for name in ['b.txt', 'a.txt']:
    open(os.path.join('demo', name), 'w').close()
print(sorted(os.listdir('demo')))
['a.txt', 'b.txt']

Только файлы с расширением .txt

Python 3.13
import os
os.makedirs('data', exist_ok=True)
for name in ['report.txt', 'photo.png', 'notes.txt']:
    open(os.path.join('data', name), 'w').close()
print(sorted(name for name in os.listdir('data') if name.endswith('.txt')))
['notes.txt', 'report.txt']

Подробности

Специальные записи . и .. в список не входят. Если каталога нет, вызывает FileNotFoundError.

Смотрите также