Модулем в Python называют обычный файл с расширением .py. В нём лежат функции, переменные и классы, которые другой файл подключает командой import. Имя модуля совпадает с именем файла: из prices.py получится модуль prices, а его функция станет доступна как prices.with_discount().
Готовых модулей в Python сотни: math, random, json приходят вместе с интерпретатором, сторонние ставятся через pip. Свой модуль пишется за минуту: достаточно сохранить функцию в отдельный файл и подключить его по имени. Сами функции, которые обычно кладут в модуль, подробно разобраны в статье о функциях в Python.
Если вы искали модуль числа, то есть абсолютное значение, вам нужна функция abs(): это другая тема, хоть и с тем же словом.
SkillboxПрофессия «Python-разработчик»157 335 ₽10 месяцев
НетологияFullstack-разработчик на Python137 000 ₽21 месяц
GeekBrainsДО Профессия Python-разработчик149 001 ₽10 месяцев
SkillFactoryПрофессия Python-разработчик140 040 ₽10 месяцев
Академия СинергияPython-разработчик + ИИ77 900 ₽6 месяцев
ЭдюсонPython-разработчик89 919 ₽9 месяцев
Как создать свой модуль в питоне: пошаговая инструкция

Возьмём задачу, которая встречается в любом учебном проекте: функцию расчёта скидки нужно вызывать из нескольких файлов. Копировать её в каждый файл неудобно, поэтому вынесем её в отдельный модуль.
- Создайте в папке проекта файл
prices.py. - Положите в него функцию и константу:
"""Расчёт цен со скидкой."""
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))
- Рядом, в той же папке, создайте
main.pyи подключите модуль по имени файла без.py:
import prices
import prices
print(prices.with_discount(2490, 10))
print(prices.VAT)
print(prices.__name__)
- Запустите
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'].
Зачем в модуле проверка 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. Порядок описан в документации:
- папка, где лежит запущенный скрипт;
- папки из переменной окружения
PYTHONPATH, если она задана; - стандартные пути установки, обычно с каталогом
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.
Встроенные и сторонние модули: с чего начать
Стандартная библиотека ставится вместе с 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 начинается с чистого сеанса.
Где освоить Python системно
С модулей начинаются проекты, где файлов больше одного. Дальше идут пакеты, виртуальные окружения, тесты и структура приложения, и в одиночку по статьям эти куски складываются медленно. Если хотите пройти путь от основ до своего проекта с проверкой кода наставником, сравните программы обучения Python в каталоге: цена, длительность и формат указаны в карточках.
| Курс | Школа | Стоимость со скидкой | В рассрочку | Длительность | Обзор курса от Checkroi |
|---|---|---|---|---|---|
| Профессия «Python-разработчик» Перейти на сайт курса | 157 335 ₽ | 5987 ₽/мес. | 10 месяцев | Обзор курса | |
| Fullstack-разработчик на Python Перейти на сайт курса | 137 000 ₽ | 7125 ₽/мес. | 21 месяц | Обзор курса | |
| ДО Профессия Python-разработчик Перейти на сайт курса | 149 001 ₽ | 3167 ₽/мес. | 10 месяцев | Обзор курса | |
| Автоматизированное тестирование на Python Перейти на сайт курса | 118 754 ₽ | 4108 ₽/мес. | 9 месяцев | Обзор курса | |
| Профессия Python-разработчик Перейти на сайт курса | 140 040 ₽ | 3890 ₽/мес. | 10 месяцев | Обзор курса |
Больше программ — в полном каталоге курсов по Python




