все Python 3osфункция

os.listdir()

директории

Возвращает список имён файлов и папок в указанной директории (без сортировки). По умолчанию — текущая директория.

Синтаксис

os.listdir(path='.') -> list[str]

Порядок произвольный и зависит от файловой системы — для стабильного вывода оберните в sorted(). Специальные '.' и '..' в список не попадают. Возвращаются только имена, без пути: открывать файл нужно через os.path.join(path, name). Если нужен ещё и тип записи, os.scandir быстрее — он не делает отдельный stat на каждое имя. Путь типа bytes даёт имена типа bytes.

Примеры

import os
files = os.listdir('.')  # → ['file.py', 'data.csv', ...]
py_files = [f for f in os.listdir('.') if f.endswith('.py')]  # → все .py файлы
print(os.listdir('/tmp'))  # → содержимое /tmp
print(len(os.listdir('.')))  # → кол-во объектов в директории
sorted_files = sorted(os.listdir('.'))  # → отсортированный список

См. также

Частые ошибки

Открыть в полном глоссарииdocs.python.orgСообщить о неточности