TypeScriptAL2023에서 사용

TypeScript(TS)는 모든 JS의 기능을 제공하고 유형 시스템으로 확장하는 JavaScript(JS) 기반 프로그래밍 언어입니다. 일반적인 시나리오에서 TS로 작성된 프로그램은 먼저 JS 코드로 변환된 다음 Node.js에 의해 다른 일반 JS 프로그램으로 실행됩니다. TS의 특정 용어에서 이 번역 프로세스를 '컴파일'이라고 하며 tsc라는 '컴파일러'에 의해 수행됩니다. tsc 컴파일러 자체는 JS로 작성되므로 실행하려면 Node.js 같은 JS 런타임 환경도 필요합니다. 일부 다른 JS 런타임 환경과 달리 Node.js는 현재 실험적인 경량 TS만 지원합니다. 유형 확인을 포함한 전체 TS 지원에는 여전히 typescript 같은 타사 패키지를 사용해야 합니다. Node.js 런타임 환경에 대한 tsc(TS 컴파일러)를 가져오는 예상 방법은 typescript 노드 모듈을 설치하는 것입니다. 이는 일반적으로 npm이라는 패키지 관리자 중 하나를 사용하여 수행할 수 있습니다. npm을 사용하여 TS 컴파일러를 설치하는 방법에는 글로벌 및 프로젝트 등 두 가지가 있습니다. 공식적으로 권장되는 방법은 프로젝트별로 TS 컴파일러를 설치하여 프로젝트의 장기 일관성과 재현성을 보장하는 것입니다. 그러나 TS 컴파일러를 글로벌로 설치하는 것은 전체 호스트 및 JS 런타임에 대해 동일한 버전을 제공하므로 로컬에 TS 컴파일러가 설치되지 않은 프로젝트에도 여전히 유용할 수 있습니다. 이는 nodejs20-typescript 또는 nodejs22-typescript 같이 Amazon Linux에서 사용할 수 있는 RPM 패키지가 시스템 수준에서 글로벌로 지원되는 각 Node.js 버전에 대해 별도로 TS 컴파일러를 설치하는 정확한 방법입니다.

tsc는 어떤 Node.js 버전에도 직접 종속되지 않습니다. 컴파일러는 target 및 lib와 같은 옵션을 통해 특수 파일(tsconfig.json)에 정의된 특정 수준의 런타임 기능을 기대합니다. 이러한 옵션의 값은 JS 런타임 환경에서 지원할 수 있는(또는 지원하지 않을 수 있는) ECMAScript(ES) 표준의 버전을 나타냅니다. Node.js 버전에 따라 지원되는 ES 표준 버전이 다릅니다. Node.js 버전이 최신일수록 지원되는 ES 표준 버전이 더 높고 더 나은 완전성을 가집니다. tsconfig.json이 프로젝트의 루트 디렉터리에 없는 경우 기본 구성 옵션 세트가 사용됩니다. Node.js의 다양한 버전에 대한 호환성 테이블과 다양한 ES 표준 버전의 지원되는 기능은 node.green 섹션에서 확인할 수 있습니다. tsc에는 tsconfig.json에 정의할 수 있는 100개 이상의 다양한 옵션이 있습니다. 일부 구성 옵션이 다른 파일에 정의된 다음 기본 파일에 포함된 경우에도 구성 체인이 지원됩니다. 이 접근 방식을 사용하면 특정 버전의 Node.js와 호환되는 기본 TS 구성을 설치한 다음 프로젝트별 옵션으로 확장할 수 있습니다. 다행히 Node.js용 기본 TS 구성은 npm을 사용하여 프로젝트 폴더에 설치할 수 있는 노드 모듈로 사용할 수 있습니다. 다음은 Node.js 버전 18, 20 및 22에 대한 구성의 소스 코드입니다.

Node.js 기반 런타임 설계에는 특정 약점이 있습니다. 즉, 호스트에서 하나의 런타임 버전만 지원하며 프로젝트 수준에서 모든 종속성의 재현성과 일관성이 필요합니다. 이로 인해 TypeScript를 사용하는 다음과 같은 일반적인 접근 방식이 생겼습니다. TS 컴파일러, 현재 Node.js 버전의 TS 기본 구성, 모든 소프트웨어 종속성이 프로젝트 내에 로컬로 설치됩니다. 글로벌로 설치된 노드 모듈은 npm 같은 CLI 도구일 것으로 예상되지만, CLI 도구이기도 한 tsc가 글로벌로 설치되는 경우는 거의 없습니다. 다행히 tsc의 글로벌(시스템 전체) 및 로컬(프로젝트 내) 설치는 문제 없이 공존할 수 있으며 독립적으로 사용되는 다른 버전일 수도 있습니다. 로컬로 설치된 tsc는 npm과 함께 설치되는 npx 도구를 사용하여 실행해야 합니다. 따라서 시스템 TS 컴파일러를 사용하더라도 사용자는 Node.js(대체를 통해 활성 버전을 전환), TS 컴파일러(로컬 또는 글로벌로 설치 후 대체를 통해 활성 버전 전환) 등 런타임 구성 요소의 버전하고 특정 요구 사항에 맞게 구성할 수 있습니다.

Amazon Linux는 npm 같이 글로벌로 설치된 다른 노드 모듈과 동일한 방식으로 Node.js 버전별로 TS 컴파일러를 패키징합니다. 패키지 및 바이너리는 네임스페이스가 지정되며 이름의 일부로 Node.js의 메이저 버전을 포함합니다. 컴파일러의 기본 실행 파일 이름인 tsc는 대체 도구에 의해 런타임 시 관리되며 설치되어 실행될 Node.js의 현재 활성 버전을 가리킵니다. 이 선택은 현재 Node.js 런타임 버전에 종속되지 않습니다. 노드 실행 파일이 Node.js 20을 가리키고 tsc가 Node.js 22로 해석되도록 구성할 수 있습니다. TS 컴파일러의 네임스페이스 이름(예: tsc-{MAJOR_VERSION})을 기본 tsc 이름 구성과 독립적으로 사용할 수도 있습니다.

여러 버전의 노드와 TS 컴파일러를 동일한 시스템에 설치하고 사용하는 예제:

# Check the AL2023 release
$ cat /etc/amazon-linux-release
Amazon Linux release 2023.9.20250929 (Amazon Linux)

# Install a TypeScript compiler for Node.js 20 and 22
# Node.js 20 and 22 will be installed automatically
$ sudo dnf install -qy nodejs20-typescript nodejs22-typescript

# Check what was installed
$ rpm -q nodejs20 nodejs20-typescript nodejs22 nodejs22-typescript
nodejs20-20.19.5-1.amzn2023.0.1.x86_64
nodejs20-typescript-5.9.2-1.amzn2023.0.1.noarch
nodejs22-22.19.0-1.amzn2023.0.1.x86_64
nodejs22-typescript-5.9.2-1.amzn2023.0.1.noarch

# Check the active version of Node.js - it is version 20
$ alternatives --display node
node - status is auto.
 link currently points to /usr/bin/node-20
/usr/bin/node-20 - priority 100
 slave npmrc: /usr/lib/nodejs20/lib/node_modules/npm/npmrc
 slave npm: /usr/bin/npm-20
 slave npx: /usr/bin/npx-20
 slave node_modules: /usr/lib/nodejs20/lib/node_modules
/usr/bin/node-22 - priority 100
 slave npmrc: /usr/lib/nodejs22/lib/node_modules/npm/npmrc
 slave npm: /usr/bin/npm-22
 slave npx: /usr/bin/npx-22
 slave node_modules: /usr/lib/nodejs22/lib/node_modules
Current 'best' version is /usr/bin/node-20.

# Check the active JS runtime version for TypeScript
# Currently, the tsc compiler will be executed by Node.js 22
$ alternatives --display tsc
tsc - status is auto.
 link currently points to /usr/bin/tsc-22
/usr/bin/tsc-22 - priority 100
 slave tsserver: /usr/bin/tsserver-22
/usr/bin/tsc-20 - priority 100
 slave tsserver: /usr/bin/tsserver-20
Current 'best' version is /usr/bin/tsc-22.

# Check versions printed by executables
$ node -v
v20.19.5

$ tsc -v
Version 5.9.2

# while the node is 20, tsc is executed by node 22 anyway
$ head -1 /usr/bin/tsc
#!/usr/bin/node-22

# However, instead of default executable names, e.g. node or tsc,
# we can use namespaced names to target any installed version
$ node-20 -v
v20.19.5

$ node-22 -v
v22.19.0

$ tsc-20 -v
Version 5.9.2

$ tsc-22 -v
Version 5.9.2

$ head -1 /usr/bin/tsc-20
#!/usr/bin/node-20

$ head -1 /usr/bin/tsc-22
#!/usr/bin/node-22