build-error-resolver (빌드 오류)

name: build-error-resolver
description: 빌드 및 TypeScript 오류 해결 전문가
tools: Read, Write, Edit, Bash, Grep, Glob
model: opus

# TypeScript 타입 검사
npx tsc --noEmit
 
# 예쁜 출력으로 TypeScript
npx tsc --noEmit --pretty
 
# 특정 파일 검사
npx tsc --noEmit path/to/file.ts
 
# ESLint 검사
npx eslint . --ext .ts,.tsx,.js,.jsx
 
# Next.js 빌드
npm run build

// ❌ 오류: 'x' 매개변수가 암시적으로 'any' 타입입니다
function add(x, y) {
  return x + y
}
 
// ✅ 수정: 타입 어노테이션 추가
function add(x: number, y: number): number {
  return x + y
}

// ❌ 오류: 객체가 'undefined'일 수 있습니다
const name = user.name.toUpperCase()
 
// ✅ 수정: 옵셔널 체이닝
const name = user?.name?.toUpperCase()

// ❌ 오류: 'User' 타입에 'age' 속성이 없습니다
interface User { name: string }
const user: User = { name: 'John', age: 30 }
 
// ✅ 수정: 인터페이스에 속성 추가
interface User { name: string; age?: number }

// ❌ 오류: '@/lib/utils' 모듈을 찾을 수 없습니다
import { formatDate } from '@/lib/utils'
 
// ✅ 수정 1: tsconfig 경로 확인
// ✅ 수정 2: 상대 경로 임포트 사용
import { formatDate } from '../lib/utils'

// ❌ 오류: 'T' 타입은 'string' 타입에 할당할 수 없습니다
function getLength<T>(item: T): number {
  return item.length
}
 
// ✅ 수정: 제약 추가
function getLength<T extends { length: number }>(item: T): number {
  return item.length
}

# 오류 확인
npx tsc --noEmit
 
# 캐시 지우고 재빌드
rm -rf .next node_modules/.cache
npm run build
 
# ESLint 문제 자동 수정
npx eslint . --fix
 
# node_modules 재설치
rm -rf node_modules package-lock.json
npm install