Что такое libuv?

Что такое libuv и почему это критично для Node.js

libuv — это кроссплатформенная C-библиотека, которая обеспечивает асинхронный ввод-вывод (I/O) и является сердцем Node.js. Без libuv Node.js просто не мог бы существовать в том виде, в котором мы его знаем.

Основное назначение

libuv абстрагирует различия между операционными системами в обработке асинхронных операций. На Linux она использует epoll, на macOS — kqueue, на Windows — IOCP (I/O Completion Ports). Благодаря этому один и тот же Node.js код работает одинаково на всех платформах.

Архитектура Event Loop

libuv реализует Event Loop — ядро асинхронной модели Node.js:

EventLoop (libuv)
  ↓
1. Check timers (setTimeout, setInterval)
2. Poll I/O events (network, file system)
3. Execute callbacks
4. Check setImmediate
5. Execute close handlers
  ↓
Repeat

Каждая итерация Event Loop обрабатывает события, пришедшие от операционной системы через libuv.

Основные компоненты

1. Асинхронный I/O

• Файловые операции (fs.readFile, fs.writeFile)
• Сетевые операции (http, socket, DNS запросы)
• Работает без блокировки основного потока

2. Timers

• setTimeout, setInterval, setImmediate
• libuv управляет очередью таймеров и вызывает их в нужное время

3. Thread Pool

• Пул потоков для тяжелых операций (4-128 потоков)
• Используется для операций, которые не поддерживают асинхронность на ОС уровне
• Например, fs.stat, crypto операции, compression

4. Системные сигналы

• Обработка SIGTERM, SIGINT и других сигналов
• Graceful shutdown приложения

Как это работает под капотом

// Когда вы пишете:
fs.readFile('file.txt', (err, data) => {
  console.log(data);
});

// Происходит:
// 1. Node.js передает запрос в libuv
// 2. libuv перенаправляет на thread pool (так как fs синхронизируется с ОС)
// 3. Поток обрабатывает файл
// 4. Результат передается обратно в Event Loop
// 5. Callback вызывается в следующей итерации Event Loop

Thread Pool

Это часто упускают, но libuv управляет пулом рабочих потоков. По умолчанию используется 4 потока:

const os = require('os');
const fs = require('fs');

// Увеличиваем пул потоков
process.env.UV_THREADPOOL_SIZE = 128;

// Теперь 8 операций будут обрабатываться параллельно
for (let i = 0; i < 8; i++) {
  fs.readFile(`file${i}.txt`, () => {
    console.log(`File ${i} read`);
  });
}

Почему это важно

1. Non-blocking I/O — основа Node.js

• Один процесс может обслуживать тысячи одновременных соединений
• Нет необходимости в одном потоке на соединение (как в Apache)

2. Единый поток для JavaScript

• Весь ваш JavaScript код работает в одном потоке
• Никаких race conditions в вашем коде (благодаря single-threaded nature)

3. Производительность

• Асинхронные операции намного дешевле, чем блокирующие
• Эффективное использование системных ресурсов

Практические следствия

❌ Никогда так не делайте:

// Это заблокирует Event Loop!
const data = fs.readFileSync('file.txt');
console.log(data);

✅ Правильно:

// Асинхронно, не блокирует Event Loop
fs.readFile('file.txt', (err, data) => {
  if (err) throw err;
  console.log(data);
});

Диагностика проблем

Если ваше приложение медленное, могут быть проблемы с libuv:

1. Очередь потоков переполнена — слишком много тяжелых операций
2. Event Loop заблокирован — тяжелые синхронные операции в JavaScript
3. DNS запросы зависают — libuv кэширует результаты неправильно

// Мониторинг здоровья Event Loop
const lag = require('event-loop-lag');
setInterval(() => {
  console.log(`Event Loop lag: ${lag()}ms`);
}, 1000);

libuv — это фундамент, на котором построен весь Node.js. Понимание того, как она работает, критично для написания высокопроизводительных приложений и отладки проблем с производительностью.