파일별 변환 전략

점진적 접근 방식

# Step 1: rename
mv src/utils.js src/utils.ts
# Step 2: fix errors
npx tsc --noEmit
# Step 3: commit and repeat

시작할 위치 선택하기

# Find files with fewest imports from other project files:
grep -r "from './" src --include="*.js" | sort | uniq -c | sort -n
# Convert lowest-count files first

암시적 any 오류 처리

// Before: JS
function process(data) { return data.value; }

// After: TS (add annotation)
function process(data: { value: string }) { return data.value; }
// Or temporarily:
function process(data: any) { return data.value; }

오류를 임시로 억제하기

// TODO: type this properly in follow-up PR
// @ts-ignore
const result = complexLegacyFunction(x);

가져오기 문 업데이트하기

// No extension needed — TypeScript finds .ts
import { process } from "./utils";

서드 파티 require 변환하기

// Before: CommonJS
const fs = require("fs");
// After: ES module
import fs from "fs";

엄격 모드 단계적 적용

// tsconfig.strict.json — points to converted files only
{
  "extends": "./tsconfig.json",
  "compilerOptions": { "strict": true },
  "include": ["src/converted/**/*"]
}

남은 파일 추적하기

find src -name "*.js" | wc -l   # remaining JS files
find src -name "*.ts" | wc -l   # converted TS files

대규모 PR 피하기

# Good: one file per PR
# Bad: 50 files renamed in one PR

변환할 때마다 검사 실행하기

npm test
# Ensure all tests pass after each .js → .ts rename

복습: 파일 단위 전략

빠른 확인

학습 내용