카테고리 없음
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
해결 방법
- name 필드에 적절한 값을 입력하거나,
- name 필드를 완전히 제거하면 문제가 해결됩니다.
예시: "name": "my-project"
그 후 의존성을 설치하면 정상적으로 작동합니다. - name 필드는 반드시 영문 소문자, 숫자, 하이픈, 언드스코어만 포함을 해야한다
저장 방법
맥에서 파일을 저장하려면 Ctrl + O → Enter → Ctrl + X를 눌러 저장 후 종료합니다.
다른 운영 체제에서는 적절한 텍스트 편집기 저장 방법을 사용하시면 됩니다.
그리고 의존성 설치를 하면 잘 된다.~