@types 선택 기준

타입 패키지는 가장 가까운 출처부터 믿는다

새 라이브러리를 쓸 때는 자체 타입, DefinitelyTyped, 직접 선언 순서로 좁히고 전역 타입 범위를 함께 통제합니다.

own

자체 타입

패키지의 types 또는 exports가 타입 파일을 제공하면 별도 설치를 피합니다.

@types

커뮤니티 타입

런타임 패키지와 @types 버전이 맞는지 보고 오래된 선언인지 확인합니다.

local

직접 선언

공식 타입도 커뮤니티 타입도 없다면 사용 중인 표면만 작은 .d.ts로 점검합니다.

범위

포함 범위

types 옵션은 필요한 전역 타입만 넣어 테스트 도구 간 충돌을 줄입니다.

설치 전

npm 페이지, 패키지 파일, 타입 선언 저장소 중 어느 곳이 최신 계약인지 확인합니다.

설치 후

IDE가 잡는 정의 위치와 실제 import 경로가 같은 패키지를 가리키는지 확인합니다.

`@types`는 빠른 해결책이지만, 라이브러리가 자체 타입을 제공하기 시작하면 중복 선언과 충돌의 원인이 될 수 있습니다.