SyntaxError: Cannot use import statement outside a module

SyntaxError: Cannot use import statement outside a module 에러는 Node.js에서 import 구문을 사용할 때 발생하는 일반적인 문제입니다. Node.js는 기본적으로 CommonJS 모듈 시스템을 사용하며, import 구문은 ECMAScript Modules (ESM)을 활성화해야 사용할 수 있습니다. 

 

해결책:

package.json에 type: "module" 추가

package.json 수정 전

{
  "name": "example",
  "version": "1.0.0",
  "main": "index.js",
  "scripts": {
    "start": "node example.js"
  },
  "dependencies": {
    ...
  }
}

 

 

package.json 수정 후

{
  "name": "example",
  "version": "1.0.0",
  "main": "index.js",
  "type": "module",
  "scripts": {
    "start": "node example.js"
  },
  "dependencies": {
    ...
  }
}

 

* 이 방법을 사용하려면 최신 node를 사용하고 있어야 합니다. 버전 확인 후 필요시 node 업데이트를 진행합니다.

** 만약 확장자가 js가 아니라 mjs라면 type 별도 지정없이 사용할 수 있습니다.