1. 버전 충돌 문제

증상: npm install 시 에러 발생 혹은 기존 프로젝트 실행 안 됨

원인: 시스템에 한 가지 버전의 Node.js만 설치되어 있어 발생하는 호환성 문제입니다.

해결: 기존 Node.js를 삭제하고 nvm(Node Version Manager)을 사용하세요.

2. npm 권한 에러 (EACCES)

증상: 글로벌 패키지 설치 시 권한 거부 에러

원인: /usr/local/lib 등에 쓰기 권한이 없기 때문입니다.

해결: sudo를 쓰는 대신 nvm을 통해 사용자 폴더에 설치되도록 환경을 구성하세요.

3. 환경변수(PATH) 미등록

증상: 'node' 또는 'npm' 명령어를 찾을 수 없음

해결: nvm 설치 후 쉘 설정 파일(.zshrc 등)에 nvm 초기화 스크립트가 포함되어 있는지 확인하세요.

1분 확인 커맨드