SyntaxError: Cannot use import statement outside a module в Node.js
В файле есть строка import, а Node.js запустил его как скрипт CommonJS — в таком формате модули подключают через require. Нужно сказать Node.js, что файл — ES-модуль, или переписать import на require.
Содержание 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.
Источники
- Исходный код Node.js 18.19.1: lib/internal/modules/esm/translators.js — предупреждение To load an ES module.
- Исходный код Node.js 18.19.1: lib/internal/modules/cjs/loader.js — предупреждение выводится для главного файла приложения.
- Исходный код Node.js 22.22.1: lib/internal/modules/esm/get_format.js — предупреждение MODULE_TYPELESS_PACKAGE_JSON.
- Исходный код Node.js 22.22.1: lib/internal/modules/cjs/loader.js — повторный запуск как ES-модуля, если формат не задан как commonjs.
- Исходный код Node.js 22.22.1: src/node_options.h — detect_module и require_module включены по умолчанию.
- Исходный код Node.js 22.22.1: src/node_contextify.cc — текст Cannot use import statement outside a module.
- Документация Node.js 22: Modules: Packages — поле "type" и расширения .mjs и .cjs.
Сверено 22 октября 2026 года.
Что почитать дальше
- require is not defined in ES module scopeобратная ошибка.
- ERR_REQUIRE_ESMпакет нельзя подключить через require.
- Как установить Node.js на Ubuntuверсии из пакетов и с nodejs.org.
- Все ошибки Node.js и npmтаблица по тексту сообщения.