Поиск
Ошибки

SyntaxError: Cannot use import statement outside a module в Node.js

В файле есть строка import, а Node.js запустил его как скрипт CommonJS — в таком формате модули подключают через require. Нужно сказать Node.js, что файл — ES-модуль, или переписать import на require.

≈ 5 мин чтения
Содержание 10

Как выглядит ошибка

В Node.js 18 сначала идёт предупреждение, затем сама ошибка:

(node:1234) Warning: To load an ES module, set "type": "module" in the package.json or use the .mjs extension.
(Use `node --trace-warnings ...` to show where the warning was created)
/home/ivan/myapp/app.js:1
import express from 'express';
…
SyntaxError: Cannot use import statement outside a module

В первой строке после предупреждения — файл и номер строки с import. 1234 — номер процесса, у вас он свой.

Почему так

В Node.js два формата модулей. CommonJS — старый: пакеты подключают через require('express'). ES-модули — новый: через import express from 'express'. Файл с расширением .js без подсказки Node.js 18 считает CommonJS, а строка import в нём — ошибка синтаксиса. Подсказкой служит поле "type" в файле package.json или расширение файла: .mjs — ES-модуль, .cjs — CommonJS.

Что изменилось в Node.js 22

Node.js 22 сам замечает import в файле .js и перезапускает его как ES-модуль. Ошибки нет, но если рядом лежит package.json без поля "type", выходит предупреждение:

(node:1234) [MODULE_TYPELESS_PACKAGE_JSON] Warning: Module type of file:///home/ivan/myapp/app.js is not specified and it doesn't parse as CommonJS.
Reparsing as ES module because module syntax was detected. This incurs a performance overhead.
To eliminate this warning, add "type": "module" to /home/ivan/myapp/package.json.

Убирается оно так же, как ошибка, — способом 1. В Node.js 22 ошибка Cannot use import statement остаётся, если в package.json явно указано "type": "commonjs" или у файла расширение .cjs.

Узнать версию Node.js:

node -v

Способ 1. "type": "module" в package.json

Команды на этой странице вводятся на сервере: подключитесь к нему по SSH (как подключиться) и набирайте их в том же окне.

Откройте package.json в папке проекта в редакторе nano:

cd /home/ivan/myapp
nano package.json

Добавьте строку "type": "module", — например, после строки version. Не забудьте запятые между строками:

{
  "name": "myapp",
  "version": "1.0.0",
  "type": "module",
  "main": "app.js"
}

Теперь все файлы .js проекта — ES-модули. Если в других файлах есть require, module.exports или __dirname, они перестанут работать — как их заменить.

Способ 2. Расширение .mjs

Если ES-модуль — один файл, переименуйте его:

mv app.js app.mjs

И поменяйте имя файла там, откуда приложение запускается: в строке ExecStart файла службы, в команде PM2 или в поле "start" раздела "scripts" файла package.json.

Способ 3. Заменить import на require

Если проект на CommonJS, перепишите строки import:

БылоСтало
import express from 'express';const express = require('express');
import { readFile } from 'fs';const { readFile } = require('fs');
export default app;module.exports = app;

Не всякий пакет можно подключить через require: если пакет выпущен только как ES-модуль, будет ошибка ERR_REQUIRE_ESM.

Та же фраза в браузере

Если строку Cannot use import statement outside a module показывает консоль браузера, а не сервер, файл с import подключён на странице тегом script без type="module". Исправьте тег:

<script type="module" src="/app.js"></script>

Как проверить

cd /home/ivan/myapp
node app.js

Приложение должно запуститься без строки SyntaxError и без предупреждения. Остановите его клавишами Ctrl+C. Если приложение работает службой, перезапустите её и посмотрите журнал (команда journalctl):

sudo systemctl restart myapp
sudo journalctl -u myapp -n 50

Если приложение запущено как служба systemd, имя службы в примерах — myapp, папка — /home/ivan/myapp. Подставьте свои.

Тексты ошибок сверены с исходным кодом Node.js 18.19.1 — он ставится из пакетов Ubuntu 24.04 — и Node.js 22.22.1 из пакетов Ubuntu 26.04.

Источники

Сверено 22 октября 2026 года.

Где проверить исправление. Если ошибка случилась на рабочем сайте, исправление спокойнее сначала проверить на отдельном тестовом VPS с Ubuntu, например в Timeweb Cloud Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs. Как зайти на него после заказа — в статье Как подключиться к VPS по SSH.

Что почитать дальше