Чем отличаются import и require в Node.js и как их совмещать?

Два разных модуля, две разных эпохи

Node.js исторически поддерживал собственную систему модулей — CommonJS (require/module.exports), а затем добавил поддержку стандарта ES Modules (import/export), который используется в браузерах и современном JS. Это не два синтаксиса одного и того же — это две разные системы модулей со своими правилами загрузки, разрешения путей и жизненного цикла.

CommonJS (require)

• Загрузка синхронная: файл читается, выполняется и кэшируется в момент вызова require.
• require — это обычная функция, поэтому её можно вызывать условно, в цикле, внутри функции.
• Экспорт через module.exports или exports.xxx.
• Внутри модуля доступны __dirname, __filename, require, module — они инжектятся Node автоматически.
• Расширение по умолчанию для CommonJS — .js (если в package.json нет "type": "module") или .cjs.

// math.js (CommonJS)
function sum(a, b) {
  return a + b;
}
module.exports = { sum };

// index.js
const { sum } = require('./math');
console.log(sum(2, 3));

ES Modules (import)

• Загрузка асинхронная, разрешение импортов статически анализируется до выполнения кода (hoisting).
• import нельзя вызвать условно или внутри блока — только на верхнем уровне файла (для динамики есть import()).
• Экспорт через export / export default.
• Нет __dirname, __filename, require "из коробки" — их получают через import.meta.url.
• Поддерживает top-level await.
• Включается через "type": "module" в package.json или расширение .mjs.

// math.mjs (ES Module)
export function sum(a, b) {
  return a + b;
}

// index.mjs
import { sum } from './math.mjs';
console.log(sum(2, 3));

Как совмещать

1. Явно указывать формат расширением: .cjs — всегда CommonJS, .mjs — всегда ESM, независимо от "type" в package.json.
2. Импорт CJS из ESM работает "из коробки": import pkg from './cjs-module.cjs' — весь module.exports придёт как default-экспорт.
3. Импорт ESM из CJS напрямую через require не работает (ESM асинхронен) — нужно использовать динамический import(), который возвращает Promise.
4. Для доступа к require внутри ESM-файла используют createRequire из модуля module.
5. В package.json можно задать "exports" с полями "require" и "import", чтобы один пакет отдавал разные точки входа в зависимости от того, кто его подключает.

// внутри ESM: получить require и подключить CJS-модуль
import { createRequire } from 'module';
const require = createRequire(import.meta.url);
const legacy = require('./legacy-cjs-module.js');

// внутри CJS: подключить ESM-модуль
async function loadEsm() {
  const mod = await import('./esm-module.mjs');
  mod.doSomething();
}

На практике в новых проектах предпочитают ESM как стандарт, а совместимость с CJS поддерживают через exports-мапу в package.json и точечные createRequire/import() там, где нужно смешивать системы.