import 세이노라이프

Node.js 개발에서 TypeScript를 도입할 때 가장 먼저 마주치는 고민 중 하나는 바로 이것입니다.

TypeScript를 전역으로 설치할까? 로컬로 설치할까?

이 글에서는 두 방식의 차이점, 장단점, 실제 추천 시나리오까지 한번에 정리해드립니다.

✅ 전역 설치란?

전역 설치는 시스템 전체에 TypeScript를 설치하여 어느 프로젝트 디렉토리에서도 tsc 명령어를 사용할 수 있게 하는 방식입니다. 다음과 같은 명령어로 설치합니다:

npm install -g typescript

설치 후에는 터미널 어디에서나 다음 명령이 작동합니다:

tsc --version
tsc yourfile.ts

전역 설치의 장점

• tsc 명령을 터미널 어디서든 바로 쓸 수 있다
• CLI 툴 사용 시 빠르게 실행 가능
• 전역 설정에 익숙한 개발자에게 편리

전역 설치의 단점

• 버전 충돌 가능성: 프로젝트마다 TypeScript 버전이 다를 경우 문제 발생
• 팀 협업에서 위험: 다른 개발자의 시스템에 같은 버전이 설치되어 있다고 보장할 수 없음
• CI/CD 파이프라인에서 재현 불가

✅ 로컬 설치란?

로컬 설치는 해당 프로젝트 폴더 안에 TypeScript를 설치하는 방식입니다. 보통 개발 의존성으로 추가합니다:

npm install --save-dev typescript

설치 후에는 전역 명령 대신 npx를 사용해 실행합니다:

npx tsc
npx tsc --init

로컬 설치의 장점

• 프로젝트별로 TypeScript 버전을 고정할 수 있어 안정성 확보
• 모든 팀원이 동일한 환경에서 작업 가능
• CI/CD 환경에서도 100% 재현 가능
• package.json만 보면 어떤 버전이 쓰였는지 알 수 있다

로컬 설치의 단점

• tsc를 직접 실행하려면 npx 또는 경로를 지정해야 한다
• 여러 프로젝트를 오가며 전역 설치처럼 쓰고 싶으면 약간 번거로움

🔍 어떤 상황에 어떤 설치를 써야 할까?

• 혼자 실습하거나 빠르게 테스트하는 경우
  전역 설치도 무방합니다.
• 팀 프로젝트, 버전 관리, 협업, CI/CD 구성이 필요한 경우
  반드시 로컬 설치가 권장됩니다.

요즘 대부분의 실제 프로젝트는 typescript를 로컬로 설치하고 npx tsc 또는 tsc npm script로 실행합니다.

🧙 마무리

전역 설치는 빠르고 편리하지만, 협업과 재현성을 위해서는 로컬 설치가 훨씬 안전하고 추천되는 방식입니다.

최종적으로는 다음과 같은 전략을 추천합니다:

• CLI 툴 실습이나 글로벌 테스트용 → 전역 설치
• 실제 서비스, 팀 프로젝트, 오픈소스, CI/CD → 로컬 설치 (with --save-dev)

🎯 참고 명령어 요약

# 전역 설치
npm install -g typescript

# 로컬 설치
npm install --save-dev typescript

# 로컬 실행
npx tsc