Модули в Python: как создать свой модуль и подключить его через import

Модулем в Python называют файл .py, который подключают командой import.

Пошагово создаём свой модуль, разбираем формы import, from и as, проверку __name__ и пакеты, а затем чиним ModuleNotFoundError, циклический импорт и файл с именем стандартного модуля.

Статью написал:
Ваня Буявец, продюсер, основатель Checkroi
Ваня Буявец
Основатель Checkroi, продюсер, эксперт в выборе онлайн-курсов
Все 3330 статей автора Подписаться на Телеграм-канал
Одобрено экспертом:
Наташа Буявец, основатель Checkroi, эксперт по онлайн-курсам
Наташа Буявец
Основательница Checkroi, продюсер Youtube-каналов, эксперт по онлайн-курсам
Все 3984 экспертных мнения Подписаться на Телеграм-канал
Обложка: Модули в Python: как создать свой модуль и подключить его через import

Модулем в Python называют обычный файл с расширением .py. В нём лежат функции, переменные и классы, которые другой файл подключает командой import. Имя модуля совпадает с именем файла: из prices.py получится модуль prices, а его функция станет доступна как prices.with_discount().

Готовых модулей в Python сотни: math, random, json приходят вместе с интерпретатором, сторонние ставятся через pip. Свой модуль пишется за минуту: достаточно сохранить функцию в отдельный файл и подключить его по имени. Сами функции, которые обычно кладут в модуль, подробно разобраны в статье о функциях в Python.

Если вы искали модуль числа, то есть абсолютное значение, вам нужна функция abs(): это другая тема, хоть и с тем же словом.

Как создать свой модуль в питоне: пошаговая инструкция

Рой раскладывает код по отдельным файлам

Возьмём задачу, которая встречается в любом учебном проекте: функцию расчёта скидки нужно вызывать из нескольких файлов. Копировать её в каждый файл неудобно, поэтому вынесем её в отдельный модуль.

  1. Создайте в папке проекта файл prices.py.
  2. Положите в него функцию и константу:
"""Расчёт цен со скидкой."""

VAT = 0.2


def with_discount(price, percent):
    return round(price * (1 - percent / 100), 2)


print("prices загружен")

if __name__ == "__main__":
    print(with_discount(1000, 15))
  1. Рядом, в той же папке, создайте main.py и подключите модуль по имени файла без .py:
import prices
import prices

print(prices.with_discount(2490, 10))
print(prices.VAT)
print(prices.__name__)
  1. Запустите python3 main.py. Вывод:
prices загружен
2241.0
0.2
prices

Обратите внимание на первую строку. Модуль подключён дважды, а «prices загружен» напечатано один раз. По документации Python, «каждый модуль импортируется только один раз за сеанс интерпретатора», повторный import берёт уже загруженный объект.

Как запускать файлы из терминала, если раньше вы жали только кнопку в редакторе, показано в инструкции по запуску скрипта через командную строку.

Как подключить модуль: import, from и as

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

import math
from math import sqrt, pi
import datetime as dt
from prices import with_discount as disc

print(math.floor(7.8))
print(sqrt(16), round(pi, 3))
print(dt.date(2026, 11, 16).isoweekday())
print(disc(500, 50))
prices загружен
7
4.0 3.142
1
250.0
Запись Что появляется в файле Когда удобна
import math имя math, функции через точку: math.floor() по умолчанию: сразу видно, откуда функция
from math import sqrt, pi имена sqrt и pi без префикса нужны одно-два имени, и они встречаются часто
import datetime as dt короткий псевдоним dt длинные имена и принятые сокращения вроде import pandas as pd
from math import * все публичные имена модуля только в интерактивной консоли

Последнюю форму документация не одобряет: код с ней хуже читается, а подтянутые имена могут незаметно перекрыть ваши переменные. Список того, что модуль отдаёт наружу, покажет dir(): для нашего файла [n for n in dir(prices) if not n.startswith('_')] вернёт ['VAT', 'with_discount'].

Канал основателя Checkroi Вани Буявца3 800 человек читают мой Телеграм-канал про нейросетиСобрал промпты для Claude Code и ChatGPT, разборы ИИ-инструментов и лайфхаки по продвижению бизнеса в одном местеПрисоединиться

Зачем в модуле проверка if __name__ == "__main__"

Когда файл запускают напрямую, Python записывает в переменную __name__ строку "__main__". Когда файл импортируют, там оказывается имя модуля, это видно по последней строке вывода выше.

Отсюда приём: код под условием if с этой проверкой выполняется только при прямом запуске. Запустим сам модуль:

$ python3 prices.py
prices загружен
850.0

При импорте из main.py строки 850.0 не было. Так в одном файле живут и библиотека, и маленький тест к ней, и тест не срабатывает у тех, кто модуль подключает.

Правило: всё, что печатает, спрашивает ввод или запускает долгие вычисления, убирайте под if __name__ == "__main__":. Наш print("prices загружен") стоит снаружи специально, чтобы показать, когда модуль выполняется.

Почему код модуля вообще срабатывает при импорте: интерпретатор читает файл сверху вниз и выполняет каждую инструкцию верхнего уровня, включая def и print. Как это устроено, рассказано в статье об интерпретаторе Python.

Где Python ищет модули и что такое пакет

Пакет как коробка с модулями-файлами внутри

Встретив import spam, интерпретатор сначала проверяет встроенные модули, а потом ищет файл spam.py по списку папок sys.path. Порядок описан в документации:

  1. папка, где лежит запущенный скрипт;
  2. папки из переменной окружения PYTHONPATH, если она задана;
  3. стандартные пути установки, обычно с каталогом site-packages, куда pip кладёт сторонние библиотеки.

Посмотреть список можно так: import sys; print(sys.path). Первым элементом будет папка вашего скрипта, поэтому prices.py рядом с main.py находится без настроек.

Пакет: папка с модулями

Когда модулей становится десяток, их собирают в пакет. Это папка с файлом __init__.py, который может быть пустым:

main.py
shop/
    __init__.py
    cart.py        # def total(items): return sum(items)
from shop.cart import total
from shop import cart

print(total([100, 250]))
print(cart.total([1, 2, 3]))
350
6

Внутри пакета модули ссылаются друг на друга относительно: from . import cart. Такой файл нельзя запустить как обычный скрипт, Python ответит ImportError: attempted relative import with no known parent package. Запускайте его из корня проекта как модуль пакета, через точку и без .py: например, python3 -m shop.cart.

Когда проект из пакетов готов и его нужно отдать человеку без установленного Python, модули собирают в один исполняемый файл: как это сделать, показано в инструкции по сборке Python в exe.

CheckroiCheckroiПодборка курсов по Python574 курса • 53 школыСравните цены, школы, программу и найдите выгодные предложения по обучениюСравнить→

Встроенные и сторонние модули: с чего начать

Стандартная библиотека ставится вместе с Python. В Python 3.14 список sys.stdlib_module_names насчитывает 297 имён. Полный перечень с описаниями ведёт Python Module Index, а первыми обычно нужны эти:

Модуль Для чего Разбор у нас
math округление, корни, константы abs() и math.fabs()
random случайные числа и выбор из списка модуль random
re поиск по шаблону в тексте регулярные выражения
json чтение и запись JSON запись в JSON-файл
csv таблицы в текстовом формате формат CSV
functools кэширование и работа с функциями lru_cache
os, pathlib файлы, папки, пути —
datetime даты и время —

Сторонние модули (requests, pandas, NumPy) ставятся из каталога PyPI. В руководстве по установке пакетов команда установки записана так: python3 -m pip install "SomeProject" для macOS и Linux и py -m pip install "SomeProject" для Windows.

Ставить библиотеки удобнее в виртуальное окружение venv, чтобы у каждого проекта был свой набор. Список зависимостей проекта хранят в файле requirements.txt, а с чего начать в анализе данных, подскажет обзор pandas.

Частые ошибки с модулями и что с ними делать

Рой уверенно обходит грабли с чек-листом

ModuleNotFoundError: No module named

ModuleNotFoundError: No module named 'reqests'

Причины три, проверяйте по порядку:

  • опечатка в имени, как здесь: нужно requests;
  • сторонний пакет не установлен: python3 -m pip install requests;
  • пакет установлен, но в другой Python. Так бывает, когда в системе их два, а редактор запускает не тот, куда ставил pip. Запись python3 -m pip запускает pip тем же интерпретатором python3, поэтому пакет попадёт туда, где его потом будет искать ваш код, а в VS Code интерпретатор выбирают по инструкции по настройке редактора.

Файл назван так же, как модуль

Новичок пробует модуль random и сохраняет пробный файл как random.py. Запуск:

Traceback (most recent call last):
  File "/private/tmp/myproject/random.py", line 1, in <module>
    import random
  File "/private/tmp/myproject/random.py", line 2, in <module>
    print(random.randint(1, 6))
          ^^^^^^^^^^^^^^
AttributeError: module 'random' has no attribute 'randint' (consider renaming '/private/tmp/myproject/random.py' since it has the same name as the standard library module named 'random' and prevents importing that standard library module)

Папка скрипта стоит в sys.path первой, и import random подхватил ваш файл вместо стандартного. Решение: переименуйте файл, например в random_test.py. Те же грабли ждут с файлами json.py, csv.py, email.py.

Циклический импорт

Модуль a.py делает from b import g, а b.py в ответ делает from a import f. Запускаем run.py с одной строкой import a:

Traceback (most recent call last):
  File "/private/tmp/myproject/run.py", line 1, in <module>
    import a
  File "/private/tmp/myproject/a.py", line 1, in <module>
    from b import g
  File "/private/tmp/myproject/b.py", line 1, in <module>
    from a import f
ImportError: cannot import name 'f' from 'a' (consider renaming '/private/tmp/myproject/a.py' if it has the same name as a library you intended to import)

Подсказка Python 3.14 про переименование здесь уводит в сторону. Смотрите на цепочку в трейсбеке: a → b → a. Модуль a ещё не дочитан до функции f, а b её уже просит. Как читать трейсбек снизу вверх и перехватывать ошибки, разобрано в статье про try except.

Решение: вынесите общий код в третий модуль, который импортируют оба, или перенесите импорт внутрь функции, где он нужен.

Поправили модуль, а изменений не видно

Это то самое «один раз за сеанс». В консоли или Jupyter повторный import не перечитает файл, нужна importlib.reload():

import importlib
import prices          # VAT = 0.2
# в prices.py поменяли VAT на 0.22 и сохранили
import prices
print(prices.VAT)      # 0.2
importlib.reload(prices)
print(prices.VAT)      # 0.22

В обычном скрипте такой проблемы нет: каждый запуск python3 main.py начинается с чистого сеанса.

Ваня БуявецКанал основателя Checkroi Вани БуявцаЗабирайте промпты и обучение по нейросетям в моём Телеграм-каналеБольше 3 800 человек уже применяют Claude Code, ChatGPT и другие нейросети в работе, учёбе, бизнесе и жизниПерейти в канал

Где освоить Python системно

С модулей начинаются проекты, где файлов больше одного. Дальше идут пакеты, виртуальные окружения, тесты и структура приложения, и в одиночку по статьям эти куски складываются медленно. Если хотите пройти путь от основ до своего проекта с проверкой кода наставником, сравните программы обучения Python в каталоге: цена, длительность и формат указаны в карточках.

КурсШколаСтоимость со скидкойВ рассрочкуДлитель­ностьОбзор курса от Checkroi
Профессия «Python-разработчик»
Перейти на сайт курса
SkillboxSkillbox157 335 ₽5987 ₽/мес.10 месяцевОбзор курса
Fullstack-разработчик на Python
Перейти на сайт курса
НетологияНетология137 000 ₽7125 ₽/мес.21 месяцОбзор курса
ДО Профессия Python-разработчик
Перейти на сайт курса
GeekBrainsGeekBrains149 001 ₽3167 ₽/мес.10 месяцевОбзор курса
Автоматизированное тестирование на Python
Перейти на сайт курса
SkillboxSkillbox118 754 ₽4108 ₽/мес.9 месяцевОбзор курса
Профессия Python-разработчик
Перейти на сайт курса
SkillFactorySkillFactory140 040 ₽3890 ₽/мес.10 месяцевОбзор курса

Больше программ — в полном каталоге курсов по Python

Часто задаваемые вопросы

Что такое модуль в питоне простыми словами?

Это файл с расширением .py, в котором лежат функции, переменные и классы. Другой файл подключает его командой import по имени файла без .py: из prices.py получится модуль prices.

Как подключить свой модуль в Python?

Положите файл модуля в ту же папку, что и основной скрипт, и напишите import имя_модуля. Функции вызываются через точку: prices.with_discount(2490, 10). Если нужна одна функция, подойдёт from prices import with_discount.

Чем модуль отличается от пакета и библиотеки?

Модуль занимает один файл .py, а пакет объединяет несколько модулей в папке с файлом __init__.py. Библиотекой обычно называют готовый пакет или набор пакетов, который ставят через pip, например requests или pandas.

Какие модули есть в Python и где посмотреть весь список?

В стандартной библиотеке Python 3.14 почти три сотни модулей: math, random, json, re, datetime, os и другие. Полный перечень с описаниями ведёт официальный каталог Python Module Index на docs.python.org.

Почему появляется ModuleNotFoundError: No module named?

Обычно из-за опечатки в имени, неустановленного стороннего пакета или установки в другой интерпретатор. Проверьте написание и ставьте пакеты командой python3 -m pip install имя_пакета: так pip работает с тем же Python, которым вы запускаете код.

Как найти модуль числа в Python?

Модуль числа, то есть абсолютное значение, возвращает встроенная функция abs(): abs(-7) даст 7. К модулям-файлам она отношения не имеет, совпадает только слово.

Читайте Checkroi первым в Google
Добавьте Checkroi в избранные источники — и наши разборы курсов и обзоры школ будут показываться выше в вашей выдаче Google.
Оставить комментарий
0 комментариев
Форма комментария

Оставьте комментарий

Напишите, что думаете. Нам важно ваше мнение!