개발 환경 구성

Node.js에서 Jest까지

typescript
javascript
Published

December 8, 2025

Abstract

Node.js와 VSCode 설치부터 TypeScript 및 Jest 기반의 개발 환경을 구축하는 방법을 단계별로 안내합니다.

Vitest를 사용해서 테스트를 진행할 수 있도록 업데이트가 예정(2026년 01월 중)되어 있습니다. 그리고 pnpm을 적용하는 방법도 추가할 예정입니다. 그리고 많은 분들이 Bun에 대해서 지속적으로 문의하고 있지만, 현재(Bun v1.3) 대부분의 조직에서 Bun을 선택하고 있지 않고 있어서 시기상조라 판단해서 Bun 및 Deno 관련 논의는 차후에 진행하도록 하겠습니다.

타입스크립트(TypeScript, TS)와 제스트(Jest)를 활용한 단위 테스트 기반의 개발 환경 및 학습 환경을 구성하여 안정적이고 유지보수가 용이한 코드를 연습할 수 있도록 개발 환경을 구성하도록 하겠습니다.

요구사항

  • Node.js >= 22.x or LTS 기반의 @latest 버전
  • VSCode나 NeoVim 등의 코드 에디터 (추천: VSCode)
    • VSCode의 경우 Windows, macOS, Linux 환경에서 사용 가능 단, Linux에서 한글 자모 입력이 불편할 수 있음.

설치 및 설정 단계

타입스크립트는 자바스크립트(JavaScript, JS)의 상위집합으로, 자바스크립트의 기능을 확장하여 더 강력한 타입 시스템을 제공합니다. 타입스크립트를 사용하기 위해서는 Node.js 환경을 설정해야 합니다.

Node.js 설치하기

Node.js는 자바스크립트의 런타임 환경으로, 자바스크립트 코드를 실행할 수 있는 환경을 제공합니다. Node.js 버전은 크게 2가지로 나눌 수 있는데, LTS 버전과 개발 버전이 있습니다. LTS 버전은 안정적이고 버그가 적은 버전이며, 개발 버전은 최신 기능을 포함하고 있습니다. 따라서, 실무에서는 개발 버전을 사용하는 것이 좋습니다. 개인저인 학습에서는 가능하면 LTS를 사용해서 빠르게 새로운 기능을 익히거나 둘러보는 것을 권장합니다.

윈도우 사용자

Node.js에서 확인 하실 수 있습니다. 운영체제에 맞춰서 Node.js 버전을 확인하시고 설치 파일을 다운로드 하셔서 설치하시면 됩니다. 설치시 대부분의 경우 기본으로 제공되는 옵션 및 선택사항을 수정없이 설치하시면 됩니다. 설치 후에 터미널을 실행해서 Node.js 버전을 확인하시면 됩니다.

Node.js 다운로드
C:\practice-ts>node --version
v22.19.0
C:\practice-ts>npm --version
10.8.2

macOS 사용자

macOS 사용자는 Homebrew를 사용해서 Node.js를 설치할 수 있습니다. 가능하면 개발에 관려된 애플리케이션은 brew로 관리하시는걸 권장합니다. nvm등을 사용하는 것이 가장 좋은 선택이지만, 초기에는 Node.js를 brew로 설치하는 것을 권장합니다.

brew install node

node와 npm 명령어가 올바르게 실행되면 Node.js가 설치된 것입니다.

VSCode 설치

VSCode는 Microsoft에서 개발한 오픈소스 코드 에디터로 플러그인 기능을 통해서 다양한 형태로 활용할 수 있는 텍스트 편집기입니다. VSCode는 현재 가장 많이 사용되고 있는 코드 에디터 중 하나로, 다양한 프로그래밍 언어를 지원하고, 확장 기능을 통해서 다양한 기능을 추가할 수 있습니다.

윈도우 사용자

VSCode 다운로드

VSCode 설치 파일 다운로드 후에 설치를 진행하시면 됩니다. 설치시 Path 옵션을 체크하시면 됩니다. 다른 옵션이나 선택사항은 기본으로 설치하시면 됩니다.

VSCode 설치

macOS 사용자

macOS 사용자는 brew를 사용해서 VSCode를 설치할 수 있습니다.

brew install --cask visual-studio-code

프로젝트 초기화

npm을 사용해서 프로젝트를 초기화해보도록 하겠습니다. 한글이 포함되어 있지 않은 경로에 적당한 폴더(ts-practice)를 만들고, 해당 폴더를 VSCode로 열어주세요(윈도우의 경우 해당 폴더를 선택하고 우클릭하여 Open with Code 선택하시면 됩니다). VSCode 내부에서 터미널을 실행해서 아래 명령어를 실행해주세요.

PS C:\ts-practice> npm init -y

package.json 파일이 생성됩니다. 해당 파일에서 두 부분을 수정해주세요.

{
...
  "author": "<YOUR NAME>",
  "license": "MIT",
...
}

JavaScript 샘플 예제 생성

src 폴더를 생성하고, 해당 폴더에 sum.js 파일을 생성해주세요. sum.js 파일에 아래와 같은 코드를 작성해주세요.

function sum(a, b) {
    return a + b;
}

console.log(sum(1, 2));
console.log(sum("Hello", [0, 1, 2]));

터미널에 node src\sum.js 명령어를 실행하면 아래와 같은 결과가 출력됩니다.

3
Hello0,1,2

Node.js 관련 설치는 모두 마쳤습니다. TS 관련 설치는 다음 단계에서 진행하도록 하겠습니다.