← Back to NOTES 🌰 ← Back to Effective TypeScript

← 아이템 29 - 사용할 때는 너그럽게, 생성할 때는 엄격하게

핵심 요약

주석과 변수명에 타입 정보를 적지 말아야 한다. 타입스크립트의 타입 구문 시스템이 코드를 간결하고 구체적이며 쉽게 읽을 수 있도록 설계되었기 때문에 주석으로 타입 정보를 중복 작성할 필요가 없다. 주석은 코드와 동기화되지 않아 모순이 발생할 수 있다.

자세한 내용

주석의 문제점

1. 코드와 주석의 정보 불일치

• 주석은 코드와 동기화되지 않음
• 시간이 지나면 주석이 오래된 정보를 담게 됨
• 주석과 실제 구현이 다를 수 있음

2. 불필요한 중복

• 타입 정보는 타입 구문에 이미 있음
• 함수 시그니처로 알 수 있는 정보를 주석으로 반복
• 코드보다 주석이 더 길어지는 경우

타입스크립트 타입 구문의 장점

• 간결하고 구체적
• 컴파일러가 체크하므로 정확성 보장
• 코드와 자동으로 동기화
• IDE에서 자동 완성과 타입 정보 제공