Node.js TypeScript 기본 환경 세팅하기

 Node.js 프로젝트에 타입스크립트 기본 환경 설정하는 것을 정리합니다. 일단 node.js가 설치 되어있다고 가정합니다.

먼저 프로젝트 폴더를 만들고 터미널에 npm init -y을 입력해줍니다. 저는 start-node-ts라는 폴더에 만들어줬습니다.

다음으로 npm i typescript 를 입력해 타입스크립트를 설치합니다.

다음으로 node의 각종 기본모듈의 d.ts 추가를 위해 npm i -D @types/node 를 설치합니다. 보통 @types 하위 패키지들은 개발용으로만 필요하기 때문에 -D(대문자) 또는 --save-dev 옵션으로 설치해줍니다. 그러면 package.json의 devDependencies에 @types.node가 추가되고 node_modules/@types 가 추가됩니다.

tsc --init를 실행해서 tsconfig.json 파일을 생성합니다. compilerOptions 기본 설정에 outDir이 주석으로 되어 있는데 "./dist"로 변경해서 js로 컴파일된 파일이 저장될 폴더를 지정합니다. 2022년 2월기준 es2016으로 target이 설정되네요.

이제 간단한 타입스크립트 샘플 파일을 아래와 같이 만들고 터미널에서 tsc를 입력해 ts 파일을 js로 컴파일 합니다. node dist/person.js 를 실행하면 결과가 잘 나옵니다.

여기까지 했다면 프로젝트 진행에 불현한 것이 계속해서 수동으로 ts를 js로 컴파일 해줘야하는 것입니다. ts-node를 통해 ts 파일을 node에서 바로 실행하는 것을 추가로 정리해봤습니다.