카테고리 없음

Name contains illegal characters” 에러 해결 경험 공유

jhdev-code 2025. 1. 23. 11:19

문제 상황

개발을 하다 보면, 사소한 문제 하나가 시간과 에너지를 많이 소모하게 할 때가 있는 것 같습니다...

 

이번에는 package.json 파일에서 발생한 "Name contains illegal characters"라는 에러를 해결한 경험을 공유하고자 합니다.

 

같은 문제를 겪는 분들에게 도움이 되길 바랍니다.

 

문제원인

의존성을 설치하려고 할 때마다 아래와 같은 에러가 발생했다.

 

error ../package.json: Name contains illegal characters

 

에러를 해결하기 위해 여러 방법을 시도했으나,

시간이 지나도 원인을 찾기 어렵고 해결도 되지 않았다..

 

터미널에 nano ../package.json 명령어로 확인 하면, 다음과 같이 나왔다.

{

"name": "${PROJECT_NAME}",

"version": "1.0.0",

"description": "",

"main": "index.js",

"scripts": { "test": "echo \"Error: no test specified\" && exit 1"

},

"private": true

 

문제점 : name  

해결 방법

  1. name 필드에 적절한 값을 입력하거나,
  2. name 필드를 완전히 제거하면 문제가 해결됩니다.
    예시: "name": "my-project"
    그 후 의존성을 설치하면 정상적으로 작동합니다.
  3. name 필드는 반드시 영문 소문자, 숫자, 하이픈, 언드스코어만 포함을 해야한다

 

저장 방법
맥에서 파일을 저장하려면 Ctrl + O → Enter → Ctrl + X를 눌러 저장 후 종료합니다.
다른 운영 체제에서는 적절한 텍스트 편집기 저장 방법을 사용하시면 됩니다.

 

그리고 의존성 설치를 하면 잘 된다.~