명령줄에서 gulp를 실행했을 때 다음과 같은 오류 메시지가 나타나나요?
'gulp'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 배치 파일이 아닙니다
PowerShell 환경에서는 다음과 같이 표시됩니다.
'gulp' 용어가 cmdlet, 함수, 스크립트 파일 또는 실행할 수 있는 프로그램의 이름으로 인식되지 않습니다.
이러한 오류는 대개 두 가지 원인 때문에 발생합니다. 컴퓨터에 Gulp CLI가 전역적으로 설치되어 있지 않거나, npm 디렉터리가 Path 환경 변수에 등록되어 있지 않은 경우입니다. 아래 순서대로 따라 하면 문제를 쉽게 해결할 수 있습니다.
1. Gulp 전역 설치하기
Gulp를 전역으로 설치하려면 먼저 컴퓨터에 Node.js가 설치되어 있어야 합니다. 아직 설치하지 않았다면 NodeJS.org 공식 사이트에서 LTS 버전을 다운로드하여 설치하세요.
Node.js 설치가 완료되면 명령줄(CMD 또는 터미널)을 열고 다음 명령을 입력하여 Gulp CLI를 전역으로 설치합니다.
npm install -g gulp-cli
설치가 정상적으로 완료되면 gulp --version 명령으로 버전 정보가 출력되는지 확인해 보세요.
2. npm이 Path 환경 변수에 등록되어 있는지 확인하기
Gulp를 전역으로 설치했는데도 여전히 같은 오류가 발생한다면, 전역 npm 디렉터리가 Path 환경 변수에 올바르게 등록되어 있지 않은 것일 가능성이 높습니다. 특히 Windows에서 자주 발생하는 문제입니다.
Windows 기준 설정 방법은 다음과 같습니다.
1. 시작 메뉴를 클릭하고 "환경 변수"라고 입력한 뒤, "시스템 환경 변수 편집"을 선택합니다.
2. "시스템 속성" 창이 열리면 하단의 "환경 변수" 버튼을 클릭합니다.
3. 새로 열린 창에서 "사용자 이름의 사용자 변수" 섹션(여기서 '사용자 이름'은 본인의 계정명)에 있는 "Path" 항목을 더블클릭하거나 선택 후 "편집"을 누릅니다.
4. 환경 변수 목록에 C:\Users\사용자이름\AppData\Roaming\npm 항목이 있는지 확인합니다.
5. 해당 항목이 없다면 "새로 만들기"를 클릭해 위 경로를 추가한 후 "확인"을 눌러 저장합니다.
전역 npm 디렉터리 경로 추가가 완료되면 반드시 CLI(명령줄 인터페이스)를 종료했다가 다시 실행해야 변경된 환경 변수가 적용됩니다. 이후 gulp 명령을 입력하면 정상적으로 작동하는 것을 확인할 수 있습니다.
그래도 문제가 지속된다면 VS Code 등 일부 프로그램을 사용 중이라면 해당 프로그램까지 완전히 재시작해 보고, 그래도 안 되면 Node.js를 재설치하는 것도 좋은 방법입니다.