下载 TypeScript

根据您的使用意图,可以通过三种安装途径来安装 TypeScript:npm 模块、NuGet 包或 Visual Studio 扩展。

如果您正在使用 Node.js,则需要 npm 版本。如果您在项目中使用了 MSBuild,则需要 NuGet 包或 Visual Studio 扩展。

在您的项目中使用 TypeScript

按项目进行 TypeScript 设置,可以让您在多个项目中使用不同版本的 TypeScript,这能确保每个项目都能稳定地运行。

通过 npm

TypeScript 在 npm 注册表中作为一个名为 "typescript" 的包提供。

您需要一个 Node.js 的副本作为运行该包的环境。然后,使用像 npmyarnpnpm 这样的依赖管理工具将 TypeScript 下载到您的项目中。

npm install typescript --save-dev

所有这些依赖管理工具都支持锁文件(lockfiles),确保团队中的每个人都使用相同版本的语言。随后,您可以使用以下命令之一运行 TypeScript 编译器:

npx tsc

使用 Visual Studio

对于大多数项目类型,您可以为 MSBuild 项目(例如 ASP.NET Core 应用)获取 Nuget 包形式的 TypeScript。

当使用 Nuget 时,您可以通过 Visual Studio 安装 TypeScript,方式如下:

  • “管理 NuGet 程序包”窗口(可以通过右键点击项目节点打开)
  • Nuget 程序包管理器控制台(位于“工具” > “NuGet 程序包管理器” > “程序包管理器控制台”),然后运行:
    Install-Package Microsoft.TypeScript.MSBuild

对于不支持 Nuget 的项目类型,可以使用 TypeScript Visual Studio 扩展。您可以在 Visual Studio 中通过 扩展 > 管理扩展 安装此扩展

以下示例适用于更高级的使用场景。

全局安装 TypeScript

在所有项目中都能使用 TypeScript 会很方便,通常用于测试一些临时想法。从长远来看,代码库应优先选择项目级安装,而非全局安装,以便在不同机器上实现可重复的构建。

通过 npm

您可以使用 npm 全局安装 TypeScript,这意味着您可以在终端的任何位置使用 tsc 命令。

要执行此操作,请运行 npm install -g typescript。这将安装最新版本(当前为6.0).

通过 Visual Studio Marketplace

您可以将 TypeScript 作为 Visual Studio 扩展安装,这将允许您在 Visual Studio 中的许多 MSBuild 项目中使用 TypeScript。

最新版本可在 Visual Studio Marketplace 获取。

使用与 TypeScript 兼容的转译器

还有其他工具可以将 TypeScript 文件转换为 JavaScript 文件。出于速度考虑或为了与现有构建工具保持一致,您可能会使用这些工具。

这些项目各自负责处理文件转换,但不负责 TypeScript 编译器的类型检查部分。因此,您可能仍然需要保留上述 TypeScript 依赖,并且需要启用 isolatedModules

Babel

Babel 是一款非常流行的 JavaScript 转译器,通过插件 @babel/plugin-transform-typescript 支持 TypeScript 文件。

swc

swc 是一个用 Rust 编写的快速转译器,支持 Babel 的许多特性,包括 TypeScript。

Sucrase

Sucrase 是一个专注于开发模式下速度的 Babel 分支。Sucrase 原生支持 TypeScript。

后续步骤