1. 简介
@bazel/typescript 是一个基于 Bazel 构建系统的 TypeScript 编译器，旨在优化大型 TypeScript 应用程序的构建和运行体验。Bazel 是一个通用构建工具，可快速而可靠地构建和测试软件。与常见的构建工具不同，Bazel 使用依赖性分析和重新生成，以仅构建必需的部分，从而更快地构建代码。
2. 安装
@bazel/typescript 可以通过 npm 安装：
npm install @bazel/typescript
3. 配置
在开始使用 @bazel/typescript 之前，需要进行一些必要的配置。
3.1 WORKSPACE 文件
在项目的根目录创建 WORKSPACE 文件，并添加以下内容：
-- -------------------- ---- -------
--------------------------------------------------- -----------------
---------------
---- - ---------------------------
------ - -------------------------------------------------
--- - --------
-
-------------------------------------------- --------------------
-------------------这个配置会通过 git_repository 下载 Bazel Node.js 规则的最新版本，并通过 node_repositories() 将它们添加到项目中。
3.2 BUILD 文件
在项目的根目录创建 BUILD 文件，并添加以下内容：
package(default_visibility = ["//visibility:public"])
load("@build_bazel_rules_nodejs//:index.bzl", "nodejs_binary")
nodejs_binary(
name = "app",
entry_point = "src/index.ts",
)这个配置会创建一个名为 app 的可执行文件，它将由 src/index.ts 中的 TypeScript 代码编译而来。
3.3 tsconfig.json 文件
在项目的根目录创建 tsconfig.json 文件，并添加以下内容：
{
"extends": "@bazel/typescript/tsconfig",
"compilerOptions": {
"rootDir": ".",
"outDir": "./dist"
}
}这个配置将扩展 @bazel/typescript/tsconfig，从而继承一些 Bazel 项目必需的选项。此外，它指定 TypeScript 编译器的源代码和输出目录。
4. 使用
通过以上配置，@bazel/typescript 就已经准备好可以使用了。
4.1 编译 TypeScript 代码
要使用 @bazel/typescript 编译 TypeScript 代码，只需运行以下命令：
bazel build :app
这个命令将编译 src/index.ts 中的代码，并将输出写入 dist 目录中。
4.2 运行可执行文件
要运行编译后的可执行文件，只需运行以下命令：
bazel run :app
这个命令将启动名为 app 的可执行文件，并执行其中的代码。
5. 示例代码
例如，我们有一个文件 src/greeter.ts，其内容如下：
export class Greeter {
greet(name: string) {
console.log(`Hello, ${name}!`);
}
}我们可以在 src/index.ts 中使用 Greeter 类：
import { Greeter } from './greeter';
const greeter = new Greeter();
greeter.greet('World');然后，编译和运行代码的步骤与上文类似：
bazel build :app bazel run :app
输出将是：
Hello, World!
6. 总结
尽管配置较为复杂，但使用 @bazel/typescript 有助于优化大型 TypeScript 应用程序的构建和运行体验。通过 Bazel 的依赖性分析和重新生成，@bazel/typescript 可以构建必需的部分，从而更快地构建代码。同时，它也可以作为一个规范良好的 TypeScript 项目的范例，供大家参考。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/bazel-typescript