下载 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

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

npx tsc

使用 Visual Studio

对于大多数项目类型,你可以在 NuGet 中将 TypeScript 作为软件包获取,例如 ASP.NET Core 应用程序。

使用 NuGet 时,你可以 通过 Visual Studio 安装,使用以下命令:

  • 通过右键单击项目节点打开的“管理 NuGet 包”窗口
  • 在工具 > NuGet 包管理器 > 包管理器控制台中运行:
    Install-Package Microsoft.TypeScript.MSBuild

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

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

全局安装 TypeScript

如果能在所有项目中都可以使用 TypeScript,就会非常方便,尤其是在测试一次性想法的时候。但从长远的角度来看,代码库应优先选择项目范围的安装方式而非全局范围,因为前者便于我们在不同的机器上获得可复现的构建结果。

通过 npm 安装

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

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

通过 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。

Next Steps