[ TypeScript ] TypeScript 시작하기

 

 

🌱 Node.js 환경에서 TypeScript를 사용하는 방법은?

1. Node.js 프로젝트에 TypeScript 설정하기

1단계: 프로젝트 초기화

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

2단계: TypeScript 및 실행 도구 설치

npm install --save-dev typescript ts-node @types/node

• typescript: TypeScript 컴파일러
• ts-node: .ts 파일을 바로 실행할 수 있게 해주는 실행기
• @types/node: Node.js API의 타입 정의 파일

---

2. TypeScript 설정파일 생성

npx tsc --init

생성된 tsconfig.json에서 최소한 아래처럼 설정해줍니다:

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

---

3. 파일 구조 예시

my-ts-node-project/
├── src/
│   └── index.ts
├── dist/              ← 여기에 컴파일된 JS가 들어감
├── tsconfig.json
├── package.json

---

4. TypeScript 코드 작성 (예: src/index.ts)

const greet = (name: string): string => {
  return `Hello, ${name}!`;
};

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

---

5. 실행 방법

A. ts-node로 실행 (컴파일 없이 즉시 실행)

npx ts-node src/index.ts

B. tsc로 컴파일 후 실행

npx tsc       # src/ -> dist/로 JS 생성됨
node dist/index.js

---

6. package.json에 스크립트 추가 (선택 사항)

"scripts": {
  "start": "node dist/index.js",
  "dev": "ts-node src/index.ts",
  "build": "tsc"
}

실행은 아래처럼:

npm run dev     # 개발용 (ts-node)
npm run build   # 컴파일
npm start       # 컴파일 후 실행

---

7. 자주 함께 쓰는 라이브러리

• Express를 TypeScript로 쓸 때:
• npm install express npm install --save-dev @types/express
• dotenv, axios, fs, path 등 Node.js 표준 모듈을 사용할 경우도 @types/ 패키지를 설치해서 타입을 추가하면 좋습니다.

---

마무리 요약

항목	설명
컴파일러	typescript (tsc)
실행 도구	ts-node
타입 정의	@types/node, @types/express 등
실행 방식	npx ts-node, npx tsc + node
주요 설정파일	tsconfig.json

---

혹시 Express 기반의 API 서버를 TypeScript로 만드는 예제나
ESM (import/export) 방식 설정, 혹은 tsconfig를 더 정교하게 설정하는 것도 원하신다면 이어서 알려드릴게요.

어떤 목적의 Node.js 프로젝트인지 여쭤봐도 될까요? (예: API 서버, 백엔드 스크립트, CLI 도구 등)