Node js 삭제 윈도우 맥 환경별 노드 언인스톨 방법

Node.js 때문에 시스템이 엉망인가요? 윈도우/맥 환경별 완전 삭제 노하우를 공개합니다!

개발자라면 누구나 한 번쯤 겪는 지옥이 있죠. 바로 Node.js 버전이 꼬이거나 패키지 충돌이 일어나는 순간입니다. 예전에 Node 프로젝트를 진행하다가 아무리 다시 설치해도 에러가 계속 나서 결국 밤샘 작업을 했었어요. 그때 알았죠. 단순한 제거로는 절대 해결되지 않는다는 것을요. 근본적인 원인은 ‘잔여 파일’이었거든요. 오늘은 윈도우와 맥, 각 환경에서 Node.js 삭제를 뿌리째 뽑아내고 깔끔하게 다시 시작하는 방법을 차근차근 알려드릴게요. 이 가이드만 있다면 더 이상 Node 문제로 스트레스 받을 일은 없을 거예요.

삭제 전 필수 체크! 내 컴퓨터에 Node.js가 깔려 있긴 할까요?

제거를 시작하기 전에, 정말 설치가 되어 있는지 확인하는 과정이 중요해요. 터미널(또는 명령 프롬프트, PowerShell)을 열고 다음 명령어를 입력해 보세요. 버전 정보가 뜬다면 아직 Node가 살아있다는 증거입니다.

node -v

혹시 Node는 지웠는데 npm 때문에 문제가 생길 수도 있으니, npm 버전도 확인하는 습관을 들이세요.

npm -v

만약 버전이 나온다면, 이제 본격적으로 완전 제거를 시작해야 합니다. 이 확인 단계는 나중에 재설치 후에도 꼭 필요하니 기억해두세요!

윈도우 환경에서 Node.js를 뿌리 뽑는 확실한 방법은 무엇일까요?

윈도우 사용자분들은 제어판을 이용하는 게 가장 쉬운 시작점입니다. ‘프로그램 제거’로 들어가 Node.js를 찾아서 마우스 오른쪽 버튼을 누르고 삭제하면 끝! 하지만 아시죠? 이게 끝이 아니라는 걸요.

눈에 보이지 않는 잔여물, 특히 npm 캐시와 숨겨진 설치 폴더까지 정리해야 Node.js 삭제가 완벽해집니다. 이 부분을 소홀히 하면 재설치 후 똑같은 충돌을 겪을 수 있어요.

특히 2단계, 캐시 청소가 핵심입니다. 윈도우는 재부팅을 해줘야 환경 변수가 확실히 정리되니 이 점도 꼭 기억해 두세요.

맥(Mac)에서 Node.js 삭제, 명령어 하나로 끝낼 수 있나요?

맥 유저라면 터미널을 이용해 좀 더 섬세하게 정리할 수 있습니다. 설치할 때 Homebrew를 썼는지 아닌지에 따라 방법이 나뉘어요. 만약 Homebrew를 사용했다면 아주 간단합니다.

Homebrew를 이용했다면 1초 컷

터미널에 다음 명령어만 입력해 보세요.

brew uninstall node

아주 깔끔하게 주 파일들이 제거됩니다. 하지만 Homebrew를 사용하지 않았거나, 더 확실하게 흔적을 지우고 싶다면 수동 제거 방법을 사용해야 합니다. Node.js 삭제를 위한 명령어는 비밀번호를 요구할 수도 있어요.

터미널을 이용한 Node.js 완전 수동 제거

수동 제거는 Node가 설치된 경로의 실행 파일과 모듈을 하나하나 지우는 과정입니다. sudo rm -rf 명령어는 강력하니, 정확한 경로를 복사해서 사용하세요. 제 경험상 이 명령어를 통해 /usr/local 경로의 찌꺼기를 정리하는 것이 가장 확실했습니다.

• 실행 파일 삭제: sudo rm -rf /usr/local/bin/node
• npm 실행 파일 삭제: sudo rm -rf /usr/local/bin/npm
• 전역 모듈 폴더 삭제: sudo rm -rf /usr/local/lib/node_modules
• 헤더 파일 삭제: sudo rm -rf /usr/local/include/node

더 나아가, 사용자 계정 내의 숨겨진 설정 파일까지 정리하면 완벽합니다.

• npm 설정 파일 삭제: sudo rm -rf ~/.npm
• 빌드 관련 설정 삭제: sudo rm -rf ~/.node-gyp
• 혹시 NVM(Node 버전 매니저)을 썼다면: rm -rf ~/.nvm

맥에서 Node.js 삭제를 완료한 후에는 꼭 node -v를 실행해서 ‘command not found’라는 메시지가 나오는지 확인해야 합니다.

Node.js 삭제 후 재설치 과정에서 알아야 할 점

이제 깨끗한 상태가 되었으니 다시 설치할 차례입니다. 공식 Node.js 홈페이지에서 최신 LTS(장기 지원) 버전을 다운로드하거나, 맥 유저라면 Homebrew를 통해 다시 설치할 수 있어요.

# 맥 사용자
brew install node

설치를 마친 후에는 반드시 처음처럼 node -v와 npm -v를 입력해서 새로운 버전이 정확하게 잡히는지 확인하세요. 이 검증 과정을 통해 Node.js 삭제 후 재설치가 성공적으로 끝났음을 알 수 있습니다.

아직도 에러가 난다면? 환경 변수를 점검하는 마무리 팁

위의 과정을 모두 거쳤는데도 여전히 버전 정보가 나오거나 이상한 에러가 뜬다면, 99% 환경 변수(PATH) 문제일 가능성이 높습니다. 시스템이 Node 실행 파일을 예전 경로에서 계속 찾고 있기 때문이죠.

• 윈도우: 시스템 속성 > 고급 > 환경 변수에서 Node 관련 PATH를 완전히 제거하세요.
• 맥: ~/.zshrc 또는 ~/.bash_profile 파일을 열어 Node나 npm 관련 경로 설정 부분을 지우고 터미널을 다시 시작하세요.

이렇게 잔여 PATH까지 정리하는 것이 Node.js 삭제의 최종 목표입니다. 이 기본적인 팁들이 여러분의 개발 환경을 쾌적하게 만드는 데 큰 도움이 될 거예요!

자주 묻는 질문