10강. Node.js와 npm: 웹 프로젝트 실행 환경 준비하기

?1. 이번 강의에서 해결할 문제

Node.js와 npm 버전 관계를 모르고 전역 패키지를 반복 설치하거나, PowerShell 실행 정책 오류를 Node 미설치로 오해합니다.

✓2. 학습 목표

✓이 강의를 마치면

• Node.js 런타임과 npm 패키지 관리자를 구분합니다.
• LTS와 프로젝트 요구 버전을 확인합니다.
• 프로젝트 로컬 package.json과 npm 명령을 검증합니다.

◇3. 핵심 개념

Node.js는 JavaScript 런타임이고 npm은 Node 프로젝트 의존성과 스크립트를 관리합니다. 학습 프로젝트는 보통 지원 기간이 긴 LTS를 우선하지만, 기존 프로젝트의 engines, 문서와 lockfile 요구가 우선입니다. 설치 방식과 LTS 표시는 Node.js 다운로드와 npm 설치 문서에서 현재 상태를 확인합니다.

✎4. 단계별 실습

PowerShell · 실행 위치: 일반 PowerShell

node --version
npm.cmd --version
Get-Command node -All
Get-Command npm.cmd -All

예상 결과: Node와 npm 버전, 실제 실행 경로가 표시됩니다. npm이 ps1 실행 정책 오류를 내더라도 npm.cmd가 정상이라면 설치 자체와 정책 문제를 구분할 수 있습니다.

JavaScript · 파일 경로: D:\Dev\web\node-check\check.js

check.js

console.log(process.version);
console.log(process.execPath);
console.log(process.cwd());

PowerShell · 실행 위치: D:\Dev\web\node-check

npm.cmd init -y
node .\check.js
Get-ChildItem -Force

예상 결과: Node 버전, 실행 파일, 현재 프로젝트 경로가 출력되고 package.json이 생성됩니다. 관리자 권한은 필요하지 않습니다.

→5. 명령어와 설정이 동작하는 이유

npm init은 현재 폴더를 Node 프로젝트로 설명하는 package.json을 만듭니다. node check.js는 PATH에서 선택된 Node 실행 파일로 소스를 실행하며 process.execPath가 그 실제 위치를 보여 줍니다.

!6. 자주 하는 실수와 해결법

!자주 하는 실수

• npm 실행 정책 오류를 재설치로 해결: npm.cmd와 Get-Command로 실행 파일을 먼저 확인합니다.
• 모든 도구를 npm -g로 설치: 프로젝트 의존성은 기본적으로 로컬 설치와 scripts를 사용합니다.
• 최신 Current를 무조건 선택: 프로젝트 지원 범위와 LTS를 확인합니다.
• node_modules를 Git에 커밋: package.json과 lockfile로 재설치하고 생성 폴더는 제외합니다.

✎7. 직접 실습

✎직접 실습

Node 버전, npm 버전, 실행 경로와 package.json 위치를 기록하세요. 기존 웹 프로젝트가 있다면 package.json의 engines와 현재 Node가 호환되는지 확인합니다.

?8. 이해 점검 질문 3개

?이해 점검

1. Node.js와 npm의 역할은 어떻게 다른가요?
2. npm.cmd 검사가 PowerShell에서 유용한 이유는 무엇인가요?
3. 전역 설치보다 프로젝트 로컬 설치를 우선하는 이유는 무엇인가요?

■9. 핵심 요약

■핵심 요약

Node.js는 실행기, npm은 프로젝트 의존성과 스크립트 관리자입니다. LTS와 프로젝트 요구 버전을 맞추고 package.json과 로컬 설치로 환경을 재현합니다.