IntelliJ에서 Node.js를 인식하지 못하는 문제

프론트로 리액트 프로젝트를 잠깐 진행할 일이 있어 인텔리제이에서 환경을 세팅하다 발생한 문제.

업무용 PC에서 node를 설치한 후에 node -v 명령어를 통해 노드 버전을 확인하고 있었다. 신기하게도 VSC에서는 node가 잘 인식되지만 인텔리제이에서는 터미널에 아래와 같은 에러가 발생했다.

 

node : 'node' 용어가 cmdlet, 함수, 스크립트 파일 또는 실행할 수 있는 프로그램 이름으로 인식되지 않습니다. 이름이 정확한지 확인하고 경로가 포함된 경우 경로가 올바른지 검증한 다음 다시 시도하십시오.

 

그냥 node를 인식하지 못하고 있는듯 했다.

이런 경우는 빈번했기 때문에 나는 먼저 환경변수 설정을 체크했다.

 

---

환경변수 체크

 

1. 윈도우 검색에서 [시스템 환경 변수 편집] 검색 후 실행

2. 고급 탭 > [환경 변수] 버튼 클릭

3. 시스템 변수 목록 중 [Path] 항목 더블클릭 혹은 편집 버튼 클릭

4. nodejs 설치 경로가 포함 되어 있는지 확인 (Windows 환경의 경우 보통 C:\Program Files\nodejs\에 위치)

 

4번에서 미포함일 경우 추가해주면 웬만해서 해결되지만

나는 이미 포함되어 있었기 때문에 환경변수 문제는 아니라는 것을 알 수 있었다.

 

일단은 VSC에서 잘 작동한다는 점이 이상해서 다음으로는 인텔리제이의 터미널 설정을 체크해봤다.

 

---

 

인텔리제이 터미널 설정 체크

 

File > Settings... > Tools > Terminal > Application Settings

 

인텔리제이에서 node.js의 경로를 정확하게 매핑하기 위해 Shell Path를 수정해줄 예정이었다.

(Shell Path는 인텔리제이 터미널이 실행되는 명령어를 지정하는 곳)

 

Windows 환경의 Shell Path 기본값은 cmd.exe로 되어있어야 하지만

내 PC에는 powershell.exe로 되어있었다. 설정은 따로 한 적 없으니 인텔리제이의 기본 설정인가 싶다.

 

파워셸을 cmd.exe로 변경하고 IDE를 재실행 한 후 node 명령어를 치니 다행히 정상적으로 작동했다.

큰 문제가 아니어서 다행이다.

 

만약 cmd.exe로 되어있지만 여전히 에러가 발생한다면 아래 명령어를 Shell Path에 등록해보시길 권한다.

파워셸은 기본적으로는 시스템의 환경변수 설정을 따르지만 사용자 프로파일에 따라 추가 구성이 필요할 수도 있다고 하니까 그 부분도 체크해보면 좋을 것 같다.

cmd.exe /k "set PATH=C:\Program Files\nodejs;%PATH%"