ServBay에서 npm(Node.js 패키지 관리자) 활성화 및 사용법

npm(Node Package Manager)은 Node.js의 공식 패키지 관리 도구이자 세계 최대 오픈소스 소프트웨어 저장소 중 하나입니다. Node.js 개발자에게는 필수 툴이며, 프로젝트의 코드 의존성을 손쉽게 설치·공유·관리할 수 있도록 도와줍니다. ServBay 통합 환경을 통해 손쉽게 npm을 사용한 개발을 시작할 수 있습니다.

사전 조건

npm을 사용하려면 ServBay에서 Node.js가 먼저 설치되어 있어야 합니다.

ServBay 애플리케이션을 실행합니다.
“패키지”(Packages) 패널로 이동합니다.
Node.js 패키지를 찾아 설치가 완료되고 실행 중인지 확인합니다.

ServBay는 Node.js 환경을 자동으로 구성하며, 이 안에 npm이 포함되어 있습니다.

npm 설치 및 사용 가능 여부 확인

ServBay를 통해 설치된 Node.js는 이미 npm을 내장하고 있으며, 기본적으로 활성화되어 있습니다. 터미널에서 아래 과정을 통해 npm이 올바르게 설치되어 있는지 빠르게 확인할 수 있습니다.

터미널 앱(macOS의 경우 Terminal 등)을 엽니다.
아래 명령어로 npm의 버전을 확인합니다:
bash
```
npm -v
```
1
명령어가 정상 실행되어 버전 번호(10.2.0 또는 그 이상)가 표시되면, npm이 제대로 설치되어 즉시 사용할 수 있습니다.
bash
```
# 예시 출력
10.2.0
```
1
2
만약 "command not found: npm"과 같은 오류가 나타난다면, ServBay를 통해 Node.js 패키지가 설치되어 있는지, 그리고 ServBay 환경 변수가 올바르게 로드되었는지 확인하세요(대개 터미널 혹은 컴퓨터를 재시작하면 환경 변수 문제가 해결됩니다).

npm 최신화

ServBay에서 설치된 Node.js에는 안정적인 버전의 npm이 기본 포함되어 있지만, npm 자체는 Node.js와 별개로 자주 업데이트됩니다. 최신 기능 제공 및 버그 수정을 위해 아래 명령으로 npm을 업데이트할 수 있습니다:

bash

npm install -g npm@latest

이 명령은 최신 버전의 npm을 전역(global)으로 설치합니다. -g 옵션은 전역 설치를 의미하며, 이를 통해 어디서든 최신 npm 명령을 사용할 수 있습니다.

업데이트 완료 후, 다시 한 번 npm -v로 버전을 확인해 주세요:

bash

npm -v

npm 핵심 기능 및 주요 사용법

npm의 가장 큰 강점은 방대한 오픈소스 에코시스템과 강력한 의존성 관리 능력입니다. 일상적인 개발에서 자주 사용되는 주요 시나리오와 명령어는 다음과 같습니다.

새로운 Node.js 프로젝트 초기화

빈 디렉터리에서 새 Node.js 프로젝트를 시작할 때 npm init 명령으로 package.json 파일을 생성할 수 있습니다. 이 파일은 프로젝트의 핵심 정보, 의존성, 실행 스크립트 등을 관리합니다.

bash

cd /Applications/ServBay/www/my-new-project.servbay.demo
npm init

npm init을 실행하면 프로젝트명, 버전, 설명, 진입 파일 등을 입력하라는 안내가 나옵니다. 빠르게 기본 설정으로 생성하려면 npm init -y를 사용하세요.

프로젝트 의존성 설치

프로젝트 루트(package.json 파일이 있는 디렉터리)에서 필요한 모든 의존성 패키지를 설치하려면 아래 명령을 사용합니다.

bash

cd /Applications/ServBay/www/my-project.servbay.demo
npm install

이 명령어는 package.json의 dependencies와 devDependencies 항목을 읽고, 필요한 모듈을 프로젝트의 node_modules 디렉터리에 설치합니다.

새로운 의존성 패키지 추가

새 라이브러리나 프레임워크를 프로젝트에 추가하려면 npm install <패키지명>을 사용합니다.

bash

# 런타임 의존성 예시 (Express 프레임워크 설치)
npm install express

# 개발용 의존성 예시 (테스트 도구 Mocha 설치)
npm install mocha --save-dev

기본적으로 npm install <패키지명>은 패키지를 node_modules에 설치하고, package.json의 dependencies를 업데이트합니다. --save-dev 옵션을 사용하면 devDependencies에 등록되며, 이는 개발·테스트·빌드 도구 등에 사용됩니다.

의존성 패키지 제거

필요 없는 의존성 패키지는 아래와 같이 삭제할 수 있습니다.

bash

npm uninstall express

해당 패키지가 node_modules에서 삭제되고, package.json이 자동 업데이트됩니다.

프로젝트 의존성 업데이트

package.json에 명시된 버전 범위 내에서 최신 버전으로 의존성을 업데이트하려면 다음 명령을 이용합니다.

bash

npm update

node_modules에 설치된 패키지를 검사하여, package.json 기준으로 가장 최신의 호환되는 버전으로 업데이트합니다.

npm 스크립트(Scripts) 활용

package.json의 scripts 항목을 이용하면 나만의 명령어 스크립트를 정의할 수 있습니다. 반복적인 작업(개발 서버 실행, 테스트 실행, 빌드 등)을 자동화하는 데 매우 유용합니다.

예를 들어, 아래와 같이 package.json의 scripts를 구성할 수 있습니다:

json

{
  "name": "my-project",
  "version": "1.0.0",
  "scripts": {
    "start": "node index.js",
    "test": "mocha test/**/*.js",
    "build": "webpack --config webpack.config.js"
  },
  "dependencies": {
    "express": "^4.18.2"
  },
  "devDependencies": {
    "mocha": "^10.2.0",
    "webpack": "^5.89.0"
  }
}

이후 터미널에서 아래와 같이 npm run <스크립트명>으로 해당 작업을 실행할 수 있습니다.

bash

# 앱 실행
npm start

# 테스트 실행
npm test

# 빌드 실행
npm run build

참고로 start, test, install, restart, stop 등 일부 예약된 스크립트명은 run을 생략하고 바로 사용할 수 있습니다(npm start, npm test 등).

자주 쓰는 npm 명령어 한눈에 보기

주요 기능 외에도 자주 활용하는 npm 명령어는 다음과 같습니다.

전역 패키지 설치: 시스템 어디서든 사용할 수 있는 커맨드라인 툴 설치 시 사용.

bash

npm install -g <패키지명>
# 예) 임시 커맨드 실행용 npx 설치(보통 Node.js와 함께 설치됨)
npm install -g npx
# 예) 개발용 자동 재시작 도구 nodemon 설치
npm install -g nodemon

npx로 임시 명령 실행: npx는 npm 5.2 이상에서 기본 제공되며, node_modules/.bin에 있는 실행 파일이나 일시적으로 다운로드한 패키지의 실행 파일을 별도 글로벌 설치 없이 사용할 수 있습니다.
bash
```
# create-react-app을 전역 설치 없이 새 React 앱 생성
npx create-react-app my-react-app
```
1
2
전역 설치된 패키지 목록 확인: 현재 시스템에 전역 설치된 패키지와 버전 보기.
bash
```
npm list -g --depth=0
```
1
npm 캐시 정리: 때때로 설치 오류가 발생할 경우 캐시 문제일 수 있으니 아래 명령으로 캐시를 정리할 수 있습니다.
bash
```
npm cache clean --force
```
1
패키지 정보 확인: 해당 패키지의 상세 정보(버전, 의존성, 저장소 등) 확인.
bash
```
npm view <패키지명>
```
1
패키지 검색: npm 저장소에서 원하는 패키지 검색.
bash
```
npm search <키워드>
```
1

문제 해결 팁

npm command not found: ServBay에서 Node.js 패키지가 설치됐는지 확인하고, 터미널에서 Node.js 및 npm 설치 경로에 접근이 가능한지 확인하세요. 보통 터미널이나 컴퓨터를 재시작하면 대부분 경로 문제가 해결됩니다.
의존성 설치 실패: 네트워크 연결 상태를 점검하세요. 기업망의 프록시 설정이 npm 다운로드에 영향을 미칠 수 있으니, 필요한 경우 npm 프록시를 설정하세요. 또한 캐시 정리(npm cache clean --force) 후 재시도해보세요.
권한 문제: macOS에서 전역 설치(npm install -g) 시 권한 문제가 발생할 수 있습니다. Node Version Manager(nvm) 사용을 권장하거나, ServBay가 설치 경로를 적절히 설정했는지 확인하세요. sudo를 사용해 글로벌 설치를 강제로 시도하는 것은 복잡한 문제의 원인이 될 수 있으니 권장하지 않습니다. ServBay에서 제공하는 Node.js는 일반적으로 권한 문제가 없도록 구성되어 있어, ServBay 디렉터리 내에서는 자유롭게 사용할 수 있습니다.

요약

ServBay를 사용하면 강력한 Node.js 개발 환경을 로컬에서 손쉽게 세팅하고, 곧바로 강력한 npm 도구로 패키지 관리 및 프로젝트 개발을 시작할 수 있습니다. npm의 기본 사용법과 주요 명령어를 익히면 개발 효율이 비약적으로 증가하며, Node.js 에코시스템에 익숙해질수록 npm은 없어서는 안 될 든든한 파트너가 될 것입니다.

ServBay에서 npm(Node.js 패키지 관리자) 활성화 및 사용법 ​

사전 조건 ​

npm 설치 및 사용 가능 여부 확인 ​

npm 최신화 ​

npm 핵심 기능 및 주요 사용법 ​

새로운 Node.js 프로젝트 초기화 ​

프로젝트 의존성 설치 ​

새로운 의존성 패키지 추가 ​

의존성 패키지 제거 ​

프로젝트 의존성 업데이트 ​

npm 스크립트(Scripts) 활용 ​

자주 쓰는 npm 명령어 한눈에 보기 ​

문제 해결 팁 ​

요약 ​

ServBay에서 npm(Node.js 패키지 관리자) 활성화 및 사용법

사전 조건

npm 설치 및 사용 가능 여부 확인

npm 최신화

npm 핵심 기능 및 주요 사용법

새로운 Node.js 프로젝트 초기화

프로젝트 의존성 설치

새로운 의존성 패키지 추가

의존성 패키지 제거

프로젝트 의존성 업데이트

npm 스크립트(Scripts) 활용

자주 쓰는 npm 명령어 한눈에 보기

문제 해결 팁

요약