Node.js에서 TypeScript를 설정하고 사용하는 방법

TypeScript는 JavaScript의 정적 타입 슈퍼셋으로, 언어에 타입 안전성과 다른 기능을 추가합니다. Node.js와 함께 TypeScript를 사용하면 더 나은 툴링, 타입 검사 및 유지 관리 기능을 제공하여 개발이 향상됩니다. 이 가이드에서는 Node.js 프로젝트에서 TypeScript를 설정하고 사용하는 단계를 다룹니다.

필수 조건

Node.js로 TypeScript를 설정하기 전에 Node.js와 npm(Node Package Manager)이 시스템에 설치되어 있는지 확인하세요. 이러한 도구는 프로젝트 종속성을 관리하고 스크립트를 실행하는 데 필수적입니다.

TypeScript 설정

Node.js 프로젝트에 TypeScript를 통합하려면 다음 단계를 따르세요.

1. 새 Node.js 프로젝트 초기화: npm을 사용하여 새 디렉토리를 만들고 Node.js 프로젝트를 초기화하는 것으로 시작합니다.

mkdir my-project
cd my-project
npm init -y

2. TypeScript 설치: npm을 사용하여 TypeScript를 개발 종속성으로 설치합니다.

npm install typescript --save-dev

3. TypeScript 구성 설정: tsconfig.json이라는 이름의 TypeScript 구성 파일을 만듭니다. 이 파일은 컴파일러 옵션과 프로젝트 설정을 지정합니다.

npx tsc --init

Node.js 프로젝트의 기본 구성은 다음과 같습니다.

{
  "compilerOptions": {
    "target": "ES6",
    "module": "commonjs",
    "outDir": "./dist",
    "rootDir": "./src",
    "strict": true
  },
  "include": ["src/**/*"],
  "exclude": ["node_modules"]
}

4. TypeScript 파일 만들기: src 디렉토리에 TypeScript 파일을 추가합니다. 간단한 TypeScript 파일을 예로 들어보겠습니다.

// src/index.ts
function greet(name: string): string {
  return `Hello, ${name}!`;
}

console.log(greet("World"));

5. TypeScript 코드 컴파일: TypeScript 컴파일러를 사용하여 TypeScript 파일을 JavaScript로 컴파일합니다.

npx tsc

컴파일된 JavaScript 파일은 tsconfig.json 파일에 지정된 대로 dist 디렉토리에 출력됩니다.

6. 컴파일된 코드 실행: Node.js를 사용하여 컴파일된 JavaScript 파일을 실행합니다.

node dist/index.js

추가 팁

• 유형 정의: Node.js 라이브러리에서 더 나은 유형 지원을 위해 npm을 사용하여 DefinitelyTyped에서 유형 정의를 설치합니다. 예를 들어, Node.js에 대한 유형 정의를 추가하려면 npm install @types/node --save-dev을 실행합니다.
• Node.js 프레임워크와 함께 TypeScript를 사용하는 경우: Express와 같은 프레임워크와 함께 TypeScript를 사용하는 경우 프레임워크별 기능에 대한 유형 안전성을 활성화하기 위해 해당 유형 정의를 설치하고 구성해야 합니다.

결론

Node.js로 TypeScript를 설정하면 정적 타이핑과 고급 기능을 활용하여 코드 품질과 개발자 생산성이 향상됩니다. 설명된 단계를 따르면 TypeScript 환경을 Node.js 프로젝트에 효과적으로 통합하여 보다 견고하고 유지 관리하기 쉬운 코드를 위한 길을 열 수 있습니다.