[Error] npm create vue@3 중 SyntaxError: The requested module 'node:util' does not provide an export named 'parseArgs'

 

혹시 Vue3 시작하기를 보고 오신 분들 중에서

npm create vue@3를 하셨을 때 위와 같이 뜨시는 분들은

 

Node버전을 꼭 체크해주시길 바랍니다!

 

SyntaxError: The requested module 'node:util' does not provide an export named 'parseArgs'

 

위와 같은 에러는 Node.js 버전이 낮기 때문에 parseArgs를 지원하지 않기 때문에 생기는 오류라고 합니다.

 

parseArgs에 생소한 저또한 찾아본 결과

Node.js 16.17.0 이상에서 새롭게 도입된 함수로

커맨드라인에서 전달된 인자들을 쉽게 처리하기 위한 내장 함수라고 합니다.

import { parseArgs } from 'node:util';

const args = parseArgs({
  options: {
    name: { type: 'string' },
    force: { type: 'boolean', short: 'f' }
  }
});

console.log(args.values);
// 예: node script.js --name=hello -f
// 결과: { name: 'hello', force: true }

위는 예시코드이며 주요 특징은 아래와 같이 3가지가 있다고 합니다. 

 

• 직접 process.argv를 복잡하게 파싱할 필요 없음
• 깔끔하고 공식적인 방법으로 CLI 인자 처리 가능
• --옵션명=값 형태나 -f 같은 짧은 옵션도 처리 가능

즉, parseArgs는 node app.js --값=무엇처럼 입력한 걸 쉽게 꺼내쓰게 해주는 도구인 것 같습니다.

 

 

결과적으로 해당 오류는 위에 앞서 말했듯이 Node.js를 최소 16.17.0 이상으로 맞춰준 상태에서 하시면 됩니다.