Библиотека или фреймворк — в чём разница на самом деле

Обычно объясняют так: библиотека маленькая, фреймворк большой. Это неправда — есть огромные библиотеки и крошечные фреймворки.
Разница в другом, и она умещается в одну строку:
Библиотеку вызываешь ты. Фреймворк вызывает тебя.
Дальше — что это значит на практике и что из этого выбрать.
Кто кого вызывает
Библиотека — это ящик с инструментами. Тебе понадобилось отформатировать дату — ты достал нужный инструмент, позвал функцию, положил обратно. Главный в проекте — твой код. Он решает, что и когда запускается.
Фреймворк — это каркас дома. Стены и перекрытия уже стоят, в них оставлены проёмы. Твоя работа — заполнить проёмы: сюда страницу, сюда обработчик формы. Запускается фреймворк, и он сам решает, когда позвать твой кусок.
Это переворачивание называют инверсией управления, а формулируют по-голливудски: «не звоните нам — мы позвоним вам».
Проверка на глаз, работает всегда: найди в проекте место, где ты вызываешь чужую функцию. Есть такое — библиотека. Если наоборот, твой код лежит в файле с правильным именем и кто-то запускает его сам — фреймворк.
Как это выглядит в коде
С библиотекой ты пишешь явный вызов:
import dayjs from "dayjs";
const text = dayjs(order.createdAt).format("DD.MM.YYYY"); // позвал сам
С фреймворком ты не пишешь вызов вообще. Ты кладёшь файл app/about/page.tsx — и страница появляется по адресу /about. Никто явно её не вызывал: фреймворк нашёл файл по соглашению и запустил.
Вот эта «магия появления» — и есть главный признак фреймворка. И его главная цена: пока знаешь соглашения, всё летает; не знаешь — непонятно даже, куда смотреть.
Шесть критериев: чем они правда отличаются
- Кто главный. Библиотека: твой код. Фреймворк: сам фреймворк.
- Что даёт. Библиотека: решает одну задачу. Фреймворк: задаёт структуру всего проекта.
- Старт. Библиотека: подключил и пользуешься. Фреймворк: сначала выучи правила.
- Свобода. Библиотека: делай как хочешь. Фреймворк: делай как принято.
- Цена ухода. Библиотека: выкинул одну, переписал пару строк. Фреймворк: переписал проект.
- Когда брать. Библиотека: нужна точечная функция. Фреймворк: одинаковые задачи повторяются.
Самая недооценённая строка здесь — предпоследняя. Про скорость старта думают все, про цену ухода — почти никто, а расплачиваться приходится именно ей.
Кто есть кто
Чтобы правило перестало быть абстрактным, пройдись по знакомым названиям:
- Библиотеки:
dayjs(даты),axios(запросы),zod(проверка данных),chart.js(графики). Все они ждут, пока ты их позовёшь. - Фреймворки: Next.js, Django, Laravel, Rails. У каждого своя структура папок и свои соглашения — они запускают твой код сами.
- Спорные: Express, FastAPI, Flask. Они называют себя «минималистичными фреймворками», и это честно: ты пишешь
app.get("/users", ...)— то есть отдаёшь свою функцию, чтобы её позвали потом. Признак на месте, просто правил мало.
Кому что подойдёт
Без виляний.
Первый проект, одностраничник, скрипт, бот — библиотеки. Причина одна: цена ошибки. Ошибся с библиотекой — удалил три строки и взял другую. Ошибся с фреймворком — переписываешь всё. Пока ты не знаешь, во что превратится проект, дешевле держать решения обратимыми. Заодно увидишь, что делает каждый кусок, — подключить одну библиотеку и понять её проще, чем разобрать чужой каркас целиком.
Приложение со страницами, входом и базой — фреймворк. Здесь работает встречный аргумент: без него ты всё равно напишешь свой фреймворк, только плохой. На третьей странице начнёшь городить самодельный роутер, на пятой — свою систему шаблонов. Фреймворк — это те же решения, но принятые тысячами людей до тебя.
Отдельно про вайб-кодинг. С фреймворком модель пишет заметно быстрее: соглашения известны, кода на промпт выходит меньше. Но и ошибки дороже — модель уверенно генерирует код для старой версии фреймворка, а ты этого не видишь. С библиотеками ошибка обычно локальная и заметная сразу.
Короткое правило: не знаешь, чем всё закончится, — начни с библиотек. Знаешь, что проект будет расти, — бери фреймворк сразу, второй заход обойдётся дороже.
Как понять, что ты перерос библиотеки
Момент перехода видно по трём признакам — если узнал хотя бы два, пора смотреть в сторону фреймворка:
- Ты третий раз пишешь одно и то же. Свой разбор адресов, своя проверка, кто вошёл, своя вставка шапки в каждую страницу.
- Ты копируешь структуру папок из прошлого проекта. Значит, структура у тебя уже есть — просто она нигде не описана и живёт только в твоей голове.
- Новому человеку (или модели) непонятно, куда класть файл. У фреймворка на этот вопрос есть готовый ответ, и это половина его пользы.
Обратный признак тоже бывает: ты сражаешься с фреймворком, обходишь его правила костылями, а используешь из него две функции. Тогда ты взял каркас там, где хватило бы пары инструментов.
React — это библиотека или фреймворк?
Формально библиотека, он сам себя так называет: React отвечает только за отрисовку интерфейса. Но как только добавляешь роутер, сборку и работу с данными, набор ощущается как фреймворк. А Next.js, построенный поверх него, — уже фреймворк без оговорок.
Можно ли использовать их вместе?
Именно так обычно и делают. Фреймворк в проекте один — он держит структуру. Библиотек рядом с ним могут быть десятки: даты, графики, работа с формами.
Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.





