TypeScript란? — 타입으로 안전한 JavaScript

// JavaScript — 런타임에서야 오류 발견
function greet(user) {
    return "안녕하세요, " + user.name + "님!";
}

greet({ name: "철수" });   // ✅ 정상
greet("철수");             // ❌ 런타임 오류: user.name is undefined
greet();                   // ❌ 런타임 오류: Cannot read properties of undefined

// TypeScript — 컴파일 시점에 오류 발견
interface User {
    name: string;
}

function greet(user: User): string {
    return `안녕하세요, ${user.name}님!`;
}

greet({ name: "철수" });   // ✅
greet("철수");             // ❌ 컴파일 오류: string은 User 타입이 아님
greet();                   // ❌ 컴파일 오류: 인자가 필요함

# Node.js가 설치되어 있다고 가정

# TypeScript 전역 설치
npm install -g typescript

# 버전 확인
tsc --version
# Version 5.4.0

# 새 프로젝트
mkdir my-ts-project
cd my-ts-project
npm init -y

# TypeScript 설치
npm install -D typescript @types/node

# tsconfig.json 생성
npx tsc --init

{
  "compilerOptions": {
    "target": "ES2022",           // 출력 JavaScript 버전
    "module": "commonjs",         // 모듈 시스템
    "strict": true,               // 엄격한 타입 검사
    "outDir": "./dist",           // 컴파일 출력 폴더
    "rootDir": "./src",           // 소스 폴더
    "esModuleInterop": true       // ES 모듈 호환
  },
  "include": ["src/**/*"],
  "exclude": ["node_modules"]
}

// src/index.ts
const message: string = "Hello, TypeScript!";
console.log(message);

function add(a: number, b: number): number {
    return a + b;
}

console.log(add(1, 2));   // 3
// console.log(add("1", 2));  // ❌ 컴파일 오류

# 컴파일
npx tsc

# 실행
node dist/index.js

# 개발 중: ts-node로 바로 실행
npm install -D ts-node
npx ts-node src/index.ts

// JavaScript
function calculatePrice(price, discount) {
    return price - price * discount;
}

// TypeScript
function calculatePrice(price: number, discount: number): number {
    return price - price * discount;
}

calculatePrice(10000, 0.1);    // ✅ 9000
calculatePrice(10000, "10%"); // ❌ 컴파일 오류