[Node.js] nodemon 실행 방식 차이: nodemon app.js vs npx nodemon app.js

📌 nodemon 실행 방식 차이: nodemon app.js vs npx nodemon app.js (설치부터 실행까지!) 🚀

---

1. nodemon이란? 🔥

✅ nodemon은 Node.js 애플리케이션을 자동으로 감시하고 변경 사항이 감지되면 자동으로 서버를 재시작하는 개발 도구임.

✔ Node.js로 서버를 실행하면 코드 변경 시 매번 Ctrl + C로 서버를 종료하고 다시 실행해야 하는 번거로움이 있음.
✔ nodemon을 사용하면 코드 변경을 감지하여 자동으로 서버를 재시작해 줌.
✔ 주로 백엔드 개발 시 개발 환경에서 사용됨.

 

🔹 기본 사용법

nodemon app.js

• app.js 파일을 실행하고, 파일 변경이 감지되면 자동으로 다시 실행됨.

🔹 특정 파일 확장자를 감시하려면?

nodemon --ext js,json

• .js, .json 파일이 변경될 때만 재시작하도록 설정.

🔹 실행 시 특정 스크립트 실행 가능

nodemon --exec python myscript.py

• nodemon을 사용하여 Node.js가 아닌 Python 스크립트도 실행 가능.

---

2. nodemon 설치 방법 🛠️

✅ 전역(글로벌) 설치:

npm install -g nodemon

• 모든 프로젝트에서 사용 가능하지만, 프로젝트마다 버전이 다를 수 있음.
• nodemon app.js 명령어를 어디서든 실행 가능.

✅ 로컬(프로젝트 내) 설치:

npm install --save-dev nodemon

• 프로젝트 폴더 내 node_modules/.bin/에 설치됨.
• package.json의 devDependencies에 포함됨.
• 해당 프로젝트 폴더 내에서 실행해야 함.

---

3. npx란? 💡

✅ npx는 npm에 포함된 패키지 실행 도구로, 프로젝트에 설치된 패키지를 실행할 때 사용됨.

✔ npx 패키지명을 입력하면 현재 프로젝트의 node_modules/.bin/에서 먼저 실행
✔ 만약 해당 패키지가 설치되지 않았다면, 자동으로 다운로드하여 실행 (일시적 다운로드 가능)

🔹 예를 들어, npx nodemon app.js를 실행하면:

1. 현재 프로젝트 내의 node_modules/.bin/nodemon을 찾아 실행
2. 만약 존재하지 않으면, npm 레지스트리에서 nodemon을 다운로드하여 실행
3. 다운로드된 패키지는 캐시되어, 다음 실행 시 더 빠르게 실행됨

👉 즉, npx nodemon app.js는 항상 프로젝트에 맞는 nodemon을 실행하며, 없으면 다운로드하여 사용함.

---

4. nodemon app.js vs npx nodemon app.js 차이점 🔍

 

실행 방식	동작 원리	실행 가능 조건
nodemon app.js	환경 변수에 등록된 nodemon 실행	1) 글로벌 설치한 경우 2) node_modules/.bin/이 PATH에 포함된 경우
npx nodemon app.js	현재 프로젝트의 node_modules/.bin/nodemon 실행	nodemon이 로컬에 설치되어 있거나, 없으면 자동 다운로드

---

5. nodemon app.js도 실행되는 이유는? 🤔

이 질문이 나오는 이유는 프로젝트에 nodemon을 로컬로 설치했을 때, npx nodemon app.js가 아니라 nodemon app.js도 실행된다는 점 때문!
"그럼 굳이 npx를 써야 하나?" 라는 의문이 들 수 있기 때문임.

📌 (1) node_modules/.bin/이 PATH에 포함된 경우

• npm은 실행 가능한 바이너리를 node_modules/.bin/에 저장함.
• 터미널에서 명령어를 입력할 때, node_modules/.bin/ 경로를 자동으로 검색하는 경우가 있음.
• 이 경우, nodemon을 글로벌로 설치하지 않았더라도 nodemon app.js가 실행될 수 있음.

🔹 확인 방법 (node_modules/.bin이 PATH에 포함되었는지 체크)

echo $PATH   # Mac/Linux
echo %PATH%  # Windows

📌 (2) 글로벌로 설치된 nodemon이 실행되는 경우

• 만약 nodemon을 npm install -g nodemon으로 글로벌 설치했다면,
  nodemon app.js 입력 시 전역 nodemon이 실행될 수도 있음.
• 이 경우 프로젝트마다 다른 nodemon 버전을 사용할 수 있어,
  예상과 다르게 동작할 가능성이 있음.

✅ 즉, nodemon app.js를 실행할 때 프로젝트에 설치된 nodemon이 실행될 수도 있고,
글로벌 설치된 nodemon이 실행될 수도 있어서, 항상 명확한 실행을 위해 npx를 사용하는 것이 안전함.

---

6. 어떤 걸 써야 할까? (추천) 🎯

✅ npx nodemon app.js를 사용하는 것이 가장 안전함!
✔ 글로벌 설치 여부와 관계없이 동작
✔ 프로젝트에 맞는 nodemon 버전을 실행
✔ nodemon이 없으면 자동 다운로드 후 실행

✅ 그냥 nodemon app.js도 괜찮지만...
✔ 프로젝트 폴더에서 실행하면 문제 없음.
✔ 하지만 다른 프로젝트에서 실행할 때, 글로벌 버전이 실행될 가능성이 있음.

---

🚀 결론

✅ 로컬 설치(-D) 후 npx nodemon app.js를 사용하는 것이 가장 안정적!
👉 글로벌 설치 없이도 가능하고, 프로젝트별로 일관된 버전 유지 가능! 💡