NPM(Node Package Manager)은 자바스크립트 패키지와 그에 따른 의존성을 관리하는 도구로, 윈도우·리눅스·macOS 등 모든 플랫폼에서 개발자들이 자주 활용하는 수많은 코드를 손쉽게 사용할 수 있게 해줍니다.
'npm: command not found' 오류가 발생하는 이유
리눅스 환경에서는 'command not found' 오류가 매우 흔하게 나타나며, 가장 큰 원인은 시스템에 해당 명령어가 설치되어 있지 않기 때문입니다. "Command 'npm' not found" 오류도 마찬가지입니다. 즉, Node Package Manager가 설치되지 않은 상태에서 터미널에 npm 명령어를 입력하면 이 오류가 발생합니다.
실제로 오류가 발생하면 터미널에 다음과 같은 메시지가 출력됩니다.
bash: npm: command not found
이 글에서는 해당 오류의 원인과 배포판별 해결 방법을 단계별로 자세히 알아보겠습니다.
해결 방법: NPM 설치하기
이 오류를 해결하는 가장 확실한 방법은 시스템에 NPM을 설치하는 것입니다. 아래 단계를 따라 진행해 보세요.
1단계: 리눅스에 NPM 설치
사용 중인 리눅스 배포판에 맞는 명령어를 선택하여 NPM을 설치합니다.
$ sudo apt install npm # Debian/Ubuntu 계열 $ sudo yum install npm # RHEL/CentOS 계열 $ sudo dnf install npm # Fedora 계열 $ sudo pacman -S npm # Arch 계열 $ sudo zypper install npm # OpenSUSE 계열
2단계: 설치 결과 확인
설치가 완료되면 아래 명령어로 정상적으로 작동하는지 확인합니다.
$ npm --version
버전 정보가 출력되면 오류가 성공적으로 해결된 것입니다.
macOS와 윈도우에서 NPM 설치하기
macOS 사용자라면 Homebrew를 통해 간편하게 설치할 수 있습니다.
$ brew install node
윈도우에서는 Node.js 공식 사이트에서 LTS 인스톨러를 다운로드해 설치하거나, winget 명령어를 이용할 수 있습니다.
winget install OpenJS.NodeJS.LTS
자주 사용하는 NPM 명령어
NPM이 정상적으로 설치되었다면, 터미널에서 패키지 검색·설치·삭제 등 다양한 작업을 수행할 수 있습니다. 가장 많이 쓰이는 명령어는 다음과 같습니다.
패키지 검색:
$ npm search package
패키지 설치:
$ npm install package
패키지 삭제:
$ npm uninstall package
설치된 패키지 목록 확인:
$ npm ls
마무리
"Command 'npm' not found" 오류는 시스템에 NPM이 설치되어 있지 않을 때 발생합니다. 사용 중인 배포판(Debian 계열, RHEL 계열, CentOS 계열 등)에 맞는 명령어로 NPM을 설치하면 누구나 간단히 해결할 수 있습니다. 이 글에서는 오류의 원인과 배포판별 해결 방법, 기본적인 NPM 사용법까지 모두 살펴보았습니다.
저자 소개
Muhammad Zubyan은 구글 IT 서포트 전문 자격증을 보유한 전문가로, 7년 이상의 실무 경험을 지니고 있습니다. 1,500대가 넘는 컴퓨터를 다루며 윈도우 관련 복잡한 문제와 오류의 근본 원인을 진단하고 해결하는 노하우를 쌓았으며, 현재는 Appuals의 수석 편집자로 활동하는 동시에 게이머와 일반 사용자 모두를 위한 게임 최적화 프로그램을 개발하고 있습니다.