Windows 및 macOS에서 Node.js 및 npm 설치 문제를 해결하고 복구하는 방법

프로젝트를 실행하려고 하는데 터미널에서 명령어가 인식되지 않거나 전역 패키지가 제대로 작동하지 않는 문제가 발생했다면 당황하지 마세요. 생각보다 흔한 문제입니다. Node.js 및 npm 설치 이러한 파일은 특히 버전이 업그레이드될 때나 운영 체제 권한이 까다로워질 때 손상되거나 문제를 일으킵니다.

이 혼란을 정리하기 위해 먼저 이해해야 할 것은 Node.js는 브라우저 외부에서 JavaScript를 실행할 수 있도록 해주는 환경이고, npm은 모든 라이브러리를 관리하는 역할을 한다는 것입니다. 이 둘이 서로 호환되지 않을 때는 현재 설치 상태를 "패치"하는 것보다는 npm을 사용하는 것이 최선의 접근 방식입니다. 꼼꼼한 청소를 하세요 그리고 향후 문제가 재발하지 않도록 하는 도구를 사용하여 다시 설치하십시오.

어떤 버전을 선택해야 할까요? LTS 버전일까요, 아니면 최신 버전일까요?

수리를 시작하기 전에 어떤 방법을 선택할지 결정해야 합니다. 버전 LTS(장기 지원) 가장 안전한 선택입니다. 프로덕션 환경에서 완벽한 안정성을 원하거나 이제 막 시작하는 단계라면 이 방법을 사용하는 것이 좋습니다. 광범위하게 테스트되었고 예상치 못한 문제가 발생하는 경우가 드물기 때문입니다.

반면에 우리는 버전 Current이곳은 최신 기능이 출시되는 "최첨단" 환경입니다. 최신 기능을 시험해 보거나 프레임워크에서 최첨단 기능을 필요로 할 때 유용하지만, 지원 기간이 짧고 버그가 더 많이 발생하는 경향이 있다는 점을 유념해야 합니다. 버그 또는 비호환성 이전 버전 패키지와 함께 사용하세요.

Windows 11에서의 복구 및 설치

Windows에서 Node.js가 제대로 작동하지 않는 경우, 경로 문제 때문인 경우가 많습니다. 공식 .msi 설치 프로그램을 사용했다면 설치 과정에서 [옵션 삽입] 옵션을 선택했는지 확인하세요. 노드를 PATH에 추가그래도 작동하지 않으면 시스템 속성으로 이동하여 경로를 수동으로 추가해야 합니다. y %AppData%\npm 사용자 환경 변수에 있습니다.

좀 더 모던하고 깔끔한 스타일을 선호하신다면, 다음을 추천합니다. 윙셋이는 이미 Windows 10 및 11에 통합되어 있습니다. 다음과 같은 간단한 명령으로 복잡한 과정 없이 모든 준비를 마칠 수 있습니다. 초콜릿을 좋아하는 분들을 위한 훌륭한 대안인 Chocolatey도 있습니다. 패키지 자동화 명령줄을 통해.

권한 문제를 피하고, 아무런 문제 없이 버전을 변경하고 싶은 사람들을 위한 해결책은 다음과 같습니다. nvm-윈도우이는 Linux/Mac용 프로젝트와는 별개의 프로젝트로, 여러 버전의 Node를 설치하고 그 사이를 전환할 수 있도록 해줍니다. 글로벌 도구가 불안정해지는 것을 방지합니다.

macOS 및 Unix 환경을 위한 솔루션

Mac에서는 공식 .pkg 패키지를 사용하는 것이 가장 일반적인 방법이지만, 워크플로우를 한 단계 더 발전시키고 싶다면, Homebrew는 도구입니다. 확정적입니다. Node를 설치할 수 있습니다. 그리고 간편하게 최신 상태로 유지할 수 있습니다. 하지만 때때로 명령어를 통해 해결되는 링크 충돌이 발생할 수 있습니다. .

하지만 macOS에서 진정한 "성배"는 바로 이것입니다. nvm(노드 버전 관리자)nvm을 통해 Node를 설치하면 파일이 제한된 시스템 디렉터리가 아닌 사용자 폴더에 저장됩니다. 이로써 골칫거리였던 문제가 완전히 해결됩니다. EACCES 권한 오류명령어를 사용할 필요가 없어집니다. 글로벌 패키지를 설치하려면.

리눅스(우분투, 데비안 또는 페도라)를 사용 중이라면 다음 스크립트를 사용하는 것이 가장 좋습니다. 노드 소스 최신 LTS 버전을 얻으려면 다음을 참고하세요. WSL(Windows Subsystem for Linux)을 사용하는 경우, Windows 바이너리와 WSL 바이너리를 혼합하여 설치하면 문제가 발생할 수 있으므로 Node를 Linux 배포판에 직접 설치하는 것이 가장 좋습니다. 경로 충돌 꽤 짜증나는 일이죠.

일반적인 오류 해결 및 유지 관리

글을 쓸 때 터미널에 명령어를 인식할 수 없다는 메시지가 표시되더라도 당황하지 마세요. 일반적으로 이는 다음과 같은 의미입니다. npm 전역 bin 디렉토리 해당 파일이 PATH에 포함되어 있지 않습니다. macOS 및 Linux에서는 파일이 PATH에 포함되어 있는지 확인하세요. o 로그인 시 nvm 구성이 올바르게 로드되므로 다음 문제가 발생하지 않습니다. localhost가 연결을 거부했습니다. 또는 이와 유사한 로컬 서버 오류.

건강한 환경을 유지하려면 단순히 설치만 하고 방치하는 것으로는 충분하지 않습니다. 실행이 필수적입니다. 때때로 감지하기 위해 보안 취약점 소속 부서에서, 만약 어떤 내용이 시대에 뒤떨어졌다고 생각되면, 긴급 업데이트가 필요한 패키지를 알려줍니다.

개발자들이 사용하는 한 가지 요령은 다음과 같습니다. npx서로 충돌할 수 있는 전역 설치로 시스템을 가득 채우는 대신, npx를 사용하면 CLI를 일시적으로 실행할 수 있습니다. 또한 pnpm이나 Yarn을 관리해야 하는 경우 npx를 활성화하세요. 코어팩 명령으로 패키지 관리자를 완벽하게 제어할 수 있도록 하기 위해서입니다.

재설치를 하기 전에 시스템을 깨끗하게 유지하려면 Windows에서 설정에서 해당 애플리케이션을 삭제하는 것뿐만 아니라, 남아 있는 폴더도 수동으로 삭제해야 합니다. 맥에서 홈브루를 사용했다면, 청소하는 것만으로도 보통 충분하지만, 청소를 ​​하는 것도 좋습니다. npm 캐시 와 과거의 실수를 되풀이하지 않도록 예방하는 것은 언제나 좋은 생각입니다.

건강한 개발 환경을 유지하려면 항상 LTS 버전을 우선시하고, NVM이나 FNM 같은 도구에 버전 관리를 맡기며, 관리자 권한으로 라이브러리를 설치하는 것을 최대한 피해야 합니다. 환경 변수를 적절히 설정하고 임시 파일을 정리하면 Node.js와 npm이 모든 운영 체제에서 원활하게 실행되도록 할 수 있습니다.