설치 문제는 증상별로 PATH, 권한, 네트워크, 버전 충돌을 좁혀 확인한다
무작정 재설치하기 전에 어떤 단계에서 실패했는지 나누면 해결 시간이 줄어든다.
| 증상 | 가능한 원인 | 먼저 확인 | 다음 조치 |
|---|---|---|---|
| node 명령을 찾지 못함 | PATH 미반영 또는 설치 실패 | 새 터미널, 설치 경로 | 재시작 후 LTS 재설치 |
| npm 명령만 실패 | npm 옵션 누락 또는 npm 손상 | Node 설치 옵션, npm -v | Node 재설치 또는 npm 복구 |
| 패키지 설치가 느리거나 실패 | 네트워크, 프록시, registry 문제 | 인터넷, 회사망, registry 설정 | 네트워크 변경 또는 cache 정리 |
| 권한 오류 발생 | 전역 설치 권한 또는 폴더 권한 | 사용자 폴더, 관리자 권한 여부 | 전역 설치 줄이고 프로젝트 로컬 사용 |
| 프로젝트마다 버전이 다름 | Node 버전 요구사항 차이 | package.json engines, 문서 요구사항 | 버전 관리자 도입 검토 |