첫 번째 Node.js 애플리케이션 설정 단계별

Source: Dev.to

위의 링크에 포함된 텍스트를 번역하려면 해당 내용을 제공해 주세요. 텍스트를 주시면 원본 서식과 코드 블록을 유지하면서 한국어로 번역해 드리겠습니다.

소개

당신이 개발자라서 빈 화면을 바라보며 꿈꾸는 웹 앱에 대한 아이디어가 가득하지만, 시작 단계에서 런타임도, 환경도 없고 어디서부터 시작해야 할지 모른다고 상상해 보세요. 익숙한가요? 이제는 그렇지 않습니다.

Node.js가 모든 것을 바꿉니다. 어제는 불가능해 보였던 것이 이제는 간단한 명령 한 줄로 해결됩니다. Node는 JavaScript 런타임이라는 강력한 엔진으로, 서버 측에서 JS를 실행하게 해 주며 Netflix, LinkedIn 같은 거대 서비스들을 구동합니다. 포트폴리오를 만들고 있는 컴퓨터 과학 전공 학생이든, 풀스택 개발에 입문한 취미 개발자이든, 이 가이드는 프레임워크 없이 순수하게 직접 설정하는 과정을 단계별로 안내합니다. 끝까지 따라오면 “Hello World” 서버가 여러분의 머신에서 울려 퍼지는 모습을 확인할 수 있습니다. 시작해 볼까요?

Installing Node.js: Setup with Platform Notes

Node.js 설치는 간단하며 운영 체제마다 일관됩니다. 황금 규칙? 최신 LTS (Long‑Term Support) 버전을 위해 공식 NodeSource 바이너리 또는 시스템의 패키지 관리자를 사용하세요. 이는 프로덕션 수준 프로젝트의 안정성을 보장합니다.

Step 1: Download from the Official Site (Universal Starting Point)

nodejs.org 로 이동하여 LTS 버전을 다운로드합니다.

Pro tip: 서드파티 다운로드 사이트를 피하여 악성코드를 방지하세요. 설치는 보통 2–5 분 정도 소요됩니다.

설치 확인

터미널을 엽니다 (Windows에서는 Command Prompt/PowerShell, macOS/Linux/NixOS에서는 Terminal) 그리고 다음을 실행합니다:

node --version
npm --version

Node는 v24.14.0 정도, npm은 11.9.0 정도의 버전이 표시되어야 합니다 (버전 번호는 다를 수 있습니다). npm은 Node와 함께 자동으로 설치되는 Node Package Manager이며, 추가 라이브러리를 설치하는 데 사용됩니다.

명령어가 버전 번호를 반환하면, 런타임이 브라우저 외부에서 JavaScript를 실행할 준비가 된 것입니다.

Node.js REPL 이해하기: 당신만의 인터랙티브 놀이터

파일을 작성하기 전에 REPL을 살펴보세요. REPL은 Read‑Eval‑Print Loop의 약자로, Node에 내장된 인터랙티브 쉘이며 코드 조각을 즉시 테스트할 수 있습니다. 터미널에서 JavaScript 콘솔처럼 동작합니다: 코드를 입력하고 Enter를 눌러 즉시 결과를 확인합니다.

실행 방법:

node

프롬프트가 > 로 바뀐 것을 볼 수 있습니다. 다음을 시도해 보세요:

> console.log('Hello, Node!')
Hello, Node!
> 2 + 2
4
> let x = 5; x * 3
15

Ctrl+C 를 두 번 누르거나 .exit 를 입력하면 종료됩니다.

REPL은 빠른 프로토타입 제작에 최적입니다—수학 로직 디버깅, 문자열 메서드 테스트, 혹은 전체 스크립트를 작성하기 전에 API를 탐색할 때 유용합니다.

첫 번째 JavaScript 파일 만들기 및 실행

이제 REPL에서 실제 파일로 이동해 보겠습니다.

1. 프로젝트 폴더 만들기

   mkdir my-first-node-app
   cd my-first-node-app

2. 편집기에서 폴더 열기 (VS Code 권장)

   code .

3. hello.js 파일 만들기 (터미널에서 touch hello.js를 사용할 수도 있습니다)

   // hello.js
   console.log('Hello from my first Node.js script!');
   console.log('Node version:', process.version);

4. 스크립트 실행하기

   node hello.js

   예상 출력 (버전은 다를 수 있습니다):

   Hello from my first Node.js script!
   Node version: v20.12.2

Node는 파일을 읽고, JIT(Just‑In‑Time)으로 컴파일한 뒤 V8 엔진(Chrome을 구동하는 엔진과 동일)에서 실행하며, 결과를 stdout에 출력합니다—브라우저가 필요 없습니다.

Source: …

Hello World 서버 만들기: 첫 서버‑사이드 앱

서버

Node.js는 내장 http 모듈을 통해 서버를 만드는 데 탁월합니다 (npm 설치 불필요). 다음 코드를 사용하여 server.js 파일을 만드세요:

// server.js
const http = require('node:http'); // CommonJS import – built‑in module

const server = http.createServer((req, res) => {
  // Basic HTTP server
  res.statusCode = 200;
  res.setHeader('Content-Type', 'text/plain');
  res.end('Hello World from Node.js Server!\n'); // Send plain‑text response
});

const port = 3000; // You can move this to a .env file (requires the `dotenv` package)
server.listen(port, 'localhost', () => {
  // Server starts listening for incoming requests
  console.log(`Server running at http://localhost:${port}/`);
});

서버 실행

node server.js

다음과 같은 메시지가 표시됩니다:

Server running at http://localhost:3000/

브라우저에서 해당 URL을 열면 “Hello World from Node.js Server!” 라는 인사를 볼 수 있습니다.

Ctrl + C 로 서버를 중지합니다.

이 간단한 예제는 Node의 이벤트‑드리븐, 논블로킹 아키텍처를 보여줍니다: 서버는 지속적으로 요청을 듣고 각 요청을 비동기적으로 처리합니다.

마무리: 제로에서 Node 히어로까지

Node.js 설치부터 라이브 서버 실행까지, 프레임워크 없이 바로 진행했습니다. 이 기반을 통해 다음을 할 수 있습니다:

• Express를 추가하여 라우팅 및 미들웨어를 사용할 수 있습니다.
• Vercel과 같은 플랫폼에 배포할 수 있습니다(포트폴리오 프로젝트에 제가 가장 많이 사용하는 서비스입니다).
• GitHub에 작업물을 공개할 수 있습니다.

Java 백엔드와 Node 실험을 병행하는 3학년 CS 학생으로서, 저는 이 워크플로우를 매일 사용합니다—힘이 됩니다.

첫 번째 프로젝트 아이디어는 무엇인가요? 댓글에 남겨 주세요!