Adoption Criteria

TypeScript의 타입 가치

타입스크립트를 켰다는 사실만으로 품질이 보장되지는 않습니다. 의도가 드러나는 경계부터 타입을 붙이고, 우회 표현을 줄이는 방식이 실제 유지보수성을 만듭니다.

얻는 것

타입을 잘 쓸 때
  • 사전 오류 컴파일 단계에서 잘못된 값 사용을 먼저 드러냅니다.
  • 코드 설명 변수와 함수가 어떤 데이터를 다루는지 읽기 쉬워집니다.
  • 변경 추적 리팩터링 중 영향을 받는 지점을 도구가 더 잘 찾습니다.
  • 팀 약속 여러 사람이 같은 데이터 구조를 일관되게 다룹니다.

주의할 것

장점이 약해질 때
  • any 남용 타입 검사의 보호막을 직접 끄는 효과가 납니다.
  • 타입 단언 근거 없는 as 사용은 오류를 감추고 나중에 터뜨립니다.
  • 느슨한 설정 컴파일러가 발견할 수 있는 문제를 지나치게 봐줍니다.
  • 런타임 경계 외부 입력은 타입 선언과 별도로 실제 검증이 필요합니다.
01

함수 경계

인자와 반환값부터 타입을 붙여 의도를 고정합니다.

02

데이터 모델

API 응답, 폼 값, 상태 구조처럼 오래 쓰는 값부터 정의합니다.

03

설정 강화

팀이 익숙해질수록 strict 옵션과 린트 규칙을 조정합니다.

04

우회 제거

임시 any와 단언을 실제 타입 모델로 바꿔 신뢰도를 높입니다.