下载 TypeScript

根据你的使用方式,TypeScript 可以通过三种安装途径获取:npm 模块、NuGet 包或 Visual Studio 扩展。

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

在项目中使用 TypeScript

在单个项目范围内安装 TypeScript,可以让你在不同项目中使用不同版本的 TypeScript,从而保持每个项目的运行一致。

通过 npm

TypeScript 在 npm 仓库上以名为 "typescript" 的包的形式提供。

你需要一份 Node.js 作为运行该包的环境。然后使用 npm、yarn 或 pnpm 之类的依赖管理器,把 TypeScript 下载到你的项目中。

npm install typescript --save-dev

这些依赖管理器都支持锁文件,可确保团队中每个人使用相同的语言版本。然后你可以用以下命令之一运行 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 中,你可以通过 Extensions > Manage Extensions安装该扩展。

以下示例面向更高级的使用场景。

全局安装 TypeScript

让 TypeScript 在所有项目中都可用会很方便,通常用于试验一次性的想法。但从长远来看,代码库更应选择项目内安装而非全局安装,这样才能在不同的机器上获得可复现的构建。

通过 npm

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

为此,请运行 npm install -g typescript。这将安装最新版本(当前为 7.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。

后续步骤