AL2023 中的 TypeScript

TypeScript（TS）是一种基于 JavaScript（JS）的编程语言，它提供 JS 的所有功能，并且还通过类型系统对其进行了扩展。在典型场景中，用 TS 编写的程序首先被翻译成 JS 代码，然后像任何其他常规 JS 程序一样由 Node.js 执行。在 TS 的特定术语中，此翻译过程被称为编译，并由称为 tsc 的编译器执行。tsc 编译器本身是用 JS 编写的，因此要运行它，也需要一个 JS 运行时环境，例如 Node.js。与其他一些 JS 运行时环境不同，Node.js 目前仅提供实验性和轻量级的 TS 支持。完整的 TS 支持，包括类型检查，仍然需要使用第三方程序包，例如 typescript。获取 Node.js 运行时环境的 tsc（TS 编译器）的预期方式是安装 typescript node 模块。这可以使用程序包管理器之一来完成，通常是 npm。使用 npm 安装 TS 编译器有两种方式：全局安装和在项目中安装。官方推荐的方法是基于每个项目安装 TS 编译器，这确保了项目的长期一致性和可复现性。然而，全局安装 TS 编译器可能仍然有用，因为它为整个主机及其 JS 运行时提供相同的版本，从而适用于本地未安装 TS 编译器的项目。这正是 Amazon Linux 上可用的 RPM 程序包（例如 nodejs20-typescript 或 nodejs22-typescript）安装 TS 编译器的方式：在系统级别全局安装，并为每个受支持的 Node.js 版本单独安装。

tsc 不直接依赖于任何 Node.js 版本。编译器期望一定级别的运行时功能，这些功能通过选项（如 target 和 lib）在特殊文件（tsconfig.json）中定义。这些选项的值代表 ECMAScript（ES）标准的一个版本，该版本可能（或可能不）被 JS 运行时环境支持。不同版本的 Node.js 支持不同版本的 ES 标准。Node.js 的版本越新，支持的 ES 标准版本越高且越完整。如果项目的根目录中不存在 tsconfig.json，则将使用默认的配置选项集。不同版本 Node.js 的兼容性表以及各种 ES 标准版本的支持特性可在 node.green 找到。tsc 有超过 100 个不同的选项，这些选项可以在 tsconfig.json 中定义。还支持配置链，即某些配置选项在另一个文件中定义，然后包含在主文件中。这种方法允许安装与特定版本 Node.js 兼容的基础 TS 配置，然后使用项目特定选项进行扩展。幸运的是，适用于 Node.js 的基础 TS 配置可作为 node 模块使用，可以使用 npm 将其安装在项目文件夹中。这是适用于 Node.js 版本 18、20 和 22 的配置源代码。

基于 Node.js 的运行时设计存在一个弱点：它在一台主机上仅支持一个运行时版本，并且要求在项目级别所有依赖项具有可复现性和一致性。这导致了以下使用 TypeScript 的常见方法：TS 编译器、当前 Node.js 版本的 TS 基础配置以及所有软件依赖项都在项目内部本地安装。虽然全局安装的 node 模块预期仅为 CLI 工具，例如 npm，但同样作为 CLI 工具的 tsc 却很少被全局安装。值得庆幸的是，tsc 的全局（系统范围内）和本地（项目内）安装可以毫无问题地共存，并且可以是独立使用的不同版本。请注意，本地安装的 tsc 应使用与 npm 一起安装的 npx 工具来执行。因此，即使有系统 TS 编译器，用户也有机会选择运行时组件的版本，例如 Node.js（通过 alternatives 切换活动版本）、TS 编译器（通过本地安装，或者全局安装并通过 alternatives 切换活动版本），并根据特定需求对其进行配置。

Amazon Linux 打包 TS 编译器的方式与其他全局安装的 node 模块（例如 npm）相同，基于每个 Node.js 版本进行。程序包和二进制文件均采用命名空间组织方式，并且在其名称中包含 Node.js 的主版本号。编译器的默认可执行文件名称 tsc 在运行时由 alternatives 工具管理，并指向当前活动的、为其安装并将由其执行的 Node.js 版本。此选择不依赖于当前的 Node.js 运行时版本。可能会出现 node 可执行文件指向 Node.js 20，而 tsc 被配置为由 Node.js 22 解释的情况。也可以使用 TS 编译器的命名空间名称，例如 tsc-{MAJOR_VERSION}，这与默认的 tsc 名称配置为何无关。

在同一系统上安装和使用多个 Node 版本及 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