환경 점검

Node npm 버전 확인

TypeScript 자체는 브라우저가 직접 실행하는 언어가 아니므로, 컴파일러를 설치하고 실행할 Node.js 런타임과 패키지 관리 도구가 먼저 준비되어야 합니다.

Node.js

컴파일러 실행 기반

tsc와 개발 도구가 동작하는 JavaScript 런타임입니다.

npm

패키지 설치 경로

typescript 패키지를 전역 또는 프로젝트 로컬에 설치합니다.

yarn

선택 가능한 관리 도구

npm과 같은 역할을 하며 팀이 정한 패키지 관리자 규칙을 따릅니다.

project local

협업 버전 고정

devDependencies에 TypeScript 버전을 고정하면 빌드 결과가 흔들리지 않습니다.

설치 확인을 코드 오류와 분리하기

node와 npm 버전이 출력되지 않으면 TypeScript 문법 문제가 아니라 환경 문제일 가능성이 큽니다. 먼저 실행 기반을 확인한 뒤 tsc와 tsconfig를 점검하면 시행착오를 줄일 수 있습니다.