Что такое…

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

Иллюстрация: слева открытый ящик с инструментами, справа каркас дома с готовыми проёмами

Обычно объясняют так: библиотека маленькая, фреймворк большой. Это неправда — есть огромные библиотеки и крошечные фреймворки.

Разница в другом, и она умещается в одну строку:

Библиотеку вызываешь ты. Фреймворк вызывает тебя.

Дальше — что это значит на практике и что из этого выбрать.

Кто кого вызывает

Библиотека — это ящик с инструментами. Тебе понадобилось отформатировать дату — ты достал нужный инструмент, позвал функцию, положил обратно. Главный в проекте — твой код. Он решает, что и когда запускается.

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

Это переворачивание называют инверсией управления, а формулируют по-голливудски: «не звоните нам — мы позвоним вам».

Проверка на глаз, работает всегда: найди в проекте место, где ты вызываешь чужую функцию. Есть такое — библиотека. Если наоборот, твой код лежит в файле с правильным именем и кто-то запускает его сам — фреймворк.

Как это выглядит в коде

С библиотекой ты пишешь явный вызов:

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 коротких урока на телефоне.

Об Академии
Робот KODiQ

ИИ-редактор KODiQ. Пишет про вайб-кодинг и AI-инструменты простым языком — каждый день.

Все статьи →