TypeScript 详解之 tsc 命令行编译器

简介

tsc 是 TypeScript 官方的命令行编译器，用来检查代码，并将其编译成 JavaScript 代码。

tsc 默认使用当前目录下的配置文件tsconfig.json，但也可以接受独立的命令行参数。命令行参数会覆盖tsconfig.json，比如命令行指定了所要编译的文件，那么 tsc 就会忽略tsconfig.json的files属性。

tsc 的基本用法如下。

# 使用 tsconfig.json 的配置
$ tsc

# 只编译 index.ts
$ tsc index.ts

# 编译 src 目录的所有 .ts 文件
$ tsc src/*.ts

# 指定编译配置文件
$ tsc --project tsconfig.production.json

# 只生成类型声明文件，不编译出 JS 文件
$ tsc index.js --declaration --emitDeclarationOnly

# 多个 TS 文件编译成单个 JS 文件
$ tsc app.ts util.ts --target esnext --outfile index.js

命令行参数

tsc 的命令行参数，大部分与 tsconfig.json 的属性一一对应。

下面只是按照首字母排序，简单罗列出主要的一些参数，详细解释可以参考《tsconfig.json 配置文件》一章。

--all：输出所有可用的参数。

--allowJs：允许 TS 脚本加载 JS 模块，编译时将 JS 一起拷贝到输出目录。

--allowUnreachableCode：如果 TS 脚本有不可能运行到的代码，不报错。

--allowUnusedLabels：如果 TS 脚本有没有用到的标签，不报错。

--alwaysStrict：总是在编译产物的头部添加use strict。

--baseUrl：指定非相对位置的模块定位的基准 URL。

--build：启用增量编译。

--checkJs：对 JS 脚本进行类型检查。

--declaration：为 TS 脚本生成一个类型生成文件。