정정지용
기술스택 목록
도구

Node.js

프로젝트 16개에서 사용했습니다. 각 프로젝트에서 어떤 역할로 썼는지 아래에 정리했습니다.

이 기술은 무엇인가요?

브라우저 밖에서 자바스크립트를 실행할 수 있게 해주는 서버사이드 런타임

Node.js는 크롬의 V8 엔진 위에서 동작하는 자바스크립트 실행 환경으로, 원래 브라우저 안에서만 쓰이던 자바스크립트를 서버, CLI 도구, 스크립트 등 어디서든 실행할 수 있게 만들어졌다. 이벤트 기반 비동기 I/O 모델을 채택해 파일, 네트워크, 외부 API 호출처럼 대기 시간이 긴 작업을 스레드를 블로킹하지 않고 처리한다. 웹 서버 프레임워크뿐 아니라 배치 스크립트, 워커, CLI 유틸리티 등 다양한 형태로 활용된다.

이럴 때 사용합니다

  • 프론트엔드와 백엔드를 같은 언어(자바스크립트/타입스크립트)로 통일하고 싶을 때
  • 외부 API 호출, DB 조회 등 I/O가 많은 서버나 워커를 가볍게 만들고 싶을 때
  • 프레임워크 없이 순수 스크립트나 CLI 도구를 빠르게 짜야 할 때
  • npm 생태계의 방대한 라이브러리를 그대로 활용하고 싶을 때

핵심 개념

Event Loop
단일 스레드로 동작하면서도 비동기 작업을 큐에 등록하고 순차적으로 처리해 동시성을 흉내내는 핵심 메커니즘이다.
Non-blocking I/O
파일 읽기, 네트워크 요청 같은 I/O 작업을 콜백이나 Promise로 위임해, 응답을 기다리는 동안 다른 코드를 계속 실행할 수 있게 한다.
npm / package.json
npm은 Node.js 생태계의 표준 패키지 매니저이며, package.json은 프로젝트의 의존성과 실행 스크립트를 정의하는 설정 파일이다.
CommonJS / ES Modules
Node.js가 지원하는 두 가지 모듈 시스템으로, require/module.exports를 쓰는 CommonJS와 import/export를 쓰는 ES Modules가 공존한다.
Single-threaded runtime
자바스크립트 실행 자체는 단일 스레드에서 이뤄지며, 무거운 I/O는 내부적으로 별도 스레드 풀이나 OS 커널에 위임한다.

가장 단순한 Node.js 스크립트 실행

외부 프레임워크 없이 Node.js 내장 http 모듈만으로 간단한 웹 서버를 띄우는 예시이며, `node index.js`로 실행한다.

JavaScript
// index.js
const http = require('http');

const server = http.createServer((req, res) => {
  res.writeHead(200, { 'Content-Type': 'text/plain' });
  res.end('Hello from Node.js\n');
});

server.listen(3000, () => {
  console.log('Server running at http://localhost:3000/');
});

처음 쓸 때 흔한 함정

  • 단일 스레드라는 이유로 무조건 느리다고 오해하지만, I/O 위주 작업에는 오히려 효율적이다.
  • 동기(sync) 함수나 무거운 연산을 실수로 메인 스레드에서 돌리면 이벤트 루프 전체가 멈춘다.
  • 콜백/Promise/async-await가 섞여 쓰이면서 비동기 흐름을 놓치기 쉽다.

위 개요는 기술 학습을 돕기 위해 자동 생성된 일반 설명입니다. 정확한 사양과 최신 정보는 공식 문서를 확인하세요.

프로젝트별 활용 방식

위 개념이 실제 프로젝트에서 어떻게 쓰였는지 보여줍니다.

  2. 02자동화
    2026년 7월

    Jira 카드 자동 개발-PR 파이프라인

    Jira 카드를 탐지해 Claude가 질문→개발→PR→완료처리까지 수행하는 루프 자동화 도구와 제어용 로컬 대시보드

    이 프로젝트에서의 Node.js 활용

    대시보드 서버와 CLI 유틸리티(render-claude-stream, run-cycle 등) 실행 환경

    jira_auto_pilot프로젝트 자세히 보기 →

함께 사용한 기술

위 프로젝트들에서 같이 쓰인 다른 기술입니다.

JavaScript5TypeScript5Jenkins3React3AWS S32Claude Code CLI2Docker2GitHub Actions2Jest2JSON2Next.js2Shell Script2