什么是 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

该主题尚不存在

您访问的页面并不存在。如果允许,您可以使用创建该页面按钮来创建它。

  • typescript/什么是tsc.txt
  • 最后更改: 2026/10/10 23:14
  • 由 张叶安