什么是 tsc
tsc 就是 TypeScript Compiler,TypeScript 官方自带的命令行编译器。它随 typescript 包一起安装,负责两件事:按类型规则检查你的代码,并把 .ts / .tsx 编译成 JavaScript。
要区分两个名字:官方的包名是 typescript,tsc 是它装出来的命令名(另一个命令 tsserver 是给编辑器用的语言服务)。
npm install -g typescript # 全局安装;项目里更推荐:npm i -D typescript tsc -v # 查看版本 npx tsc # 没有全局安装也能跑
一、它做哪三件事
| 能力 | 说明 | 相关选项 |
|---|---|---|
| 类型检查 | 按 tsconfig.json 里的规则静态检查,报告编译期错误 | strict、noImplicitAny、strictNullChecks |
| 编译成 JS | 把类型擦除,输出指定版本的 JavaScript | target、module、outDir |
| 产出附属文件 | 类型声明和调试用的映射文件 | declaration、sourceMap |
类型检查是它区别于普通转译工具的核心价值:报错发生在编译时,而不是等代码在浏览器或 Node 里跑起来才炸。
二、常用命令
tsc # 无参数:读当前目录的 tsconfig.json,全量编译 tsc --init # 生成一份 tsconfig.json 模板 tsc index.ts # 只编译指定文件(此时 tsconfig.json 会被忽略) tsc -p ./tsconfig.json # 指定配置文件(-p / --project) tsc -w # --watch,监听文件改动自动重编译 tsc --noEmit # 只做类型检查,不产出任何文件 tsc --build # 项目引用 / 增量构建(-b) tsc --showConfig # 打印最终生效的完整配置
三、常用编译选项
写在 tsconfig.json 的 compilerOptions 里:
| 选项 | 作用 |
|---|---|
target | 输出的 JS 版本,如 es5、es2022、esnext。不配置时默认 es5(TS 5.0 起,更早为 es3) |
module | 模块规范,如 commonjs、esnext、node16、nodenext |
moduleResolution | 模块解析策略,建议 module 为 node16/nodenext 时配 node16 |
outDir | 产物目录,如 ./dist |
rootDir | 源码根目录,用来保持输出目录结构 |
strict | 开启全部严格检查,建议打开 |
declaration | 额外生成 .d.ts 声明文件 |
sourceMap |