tsc 命令

文档

https://www.bookstack.cn/read/wangdoc-typescript-tutorial/docs-tsc.md

简介

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

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

基本用法

# 使用 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 脚本生成一个类型生成文件。

--declarationDir:指定生成的类型声明文件的所在目录。

--declarationMap:为.d.ts文件生成 SourceMap 文件。

--diagnostics:构建后输出编译性能信息。

--emitBOM:在编译输出的 UTF-8 文件头部加上 BOM 标志。

--emitDeclarationOnly:只编译输出类型声明文件,不输出 JS 文件。

--esModuleInterop:更容易使用 import 命令加载 CommonJS 模块。

--exactOptionalPropertyTypes:不允许将可选属性设置为undefined。

--experimentalDecorators:支持早期的装饰器语法。

--explainFiles:输出进行编译的文件信息。

--forceConsistentCasingInFileNames:文件名大小写敏感,默认打开。

--help:输出帮助信息。

--importHelpers:从外部库(比如 tslib)输入辅助函数。

--incremental:启用增量构建。

--init:在当前目录创建一个全新的tsconfig.json文件,里面是预设的设置。

--inlineSourceMap:SourceMap 信息嵌入 JS 文件,而不是生成独立的.js.map文件。

--inlineSources:将 TypeScript 源码作为 SourceMap 嵌入编译出来的 JS 文件。

--isolatedModules:确保每个模块能够独立编译,不依赖其他输入的模块。

--jsx:设置如何处理 JSX 文件。

--lib:设置目标环境需要哪些内置库的类型描述。

--listEmittedFiles:编译后输出编译产物的文件名。

--listFiles:编译过程中,列出读取的文件名。

--listFilesOnly:列出编译所要处理的文件,然后停止编译。

--locale:指定编译时输出的语言,不影响编译结果。

--mapRoot:指定 SourceMap 文件的位置。

--module:指定编译生成的模块格式。

--moduleResolution:指定如何根据模块名找到模块的位置。

--moduleSuffixes:指定模块文件的后缀名。

--newLine:指定编译产物的换行符,可以设为crlf或者lf。

--noEmit:不生成编译产物,只进行类型检查。

--noEmitHelpers:不在编译产物中加入辅助函数。

--noEmitOnError:一旦报错,就停止编译,没有编译产物。

--noFallthroughCasesInSwitch:Switch 结构的case分支必须有终止语句(比如break)。

--noImplicitAny:类型推断只要为any类型就报错。

--noImplicitReturns:函数内部没有显式返回语句(比如return)就报错。

--noImplicitThis:如果this关键字是any类型,就报错。

--noImplicitUseStrict:编译产生的 JS 文件头部不添加use strict语句。

--noResolve:不进行模块定位,除非该模块是由命令行传入。

--noUnusedLocals:如果有未使用的局部变量就报错。

--noUnusedParameters:如果有未使用的函数参数就报错。

--outDir:指定编译产物的存放目录。

--outFile:所有编译产物打包成一个指定文件。

--preserveConstEnums:不将const enum结构在生成的代码中,替换成常量。

--preserveWatchOutput: watch 模式下不清屏。

--pretty:美化显示编译时的终端输出。这是默认值,但是可以关闭--pretty false。

--project(或者-p):指定编译配置文件,或者该文件所在的目录。

--removeComments:编译结果中移除代码注释。

--resolveJsonModule:允许加载 JSON 文件。

--rootDir:指定加载文件所在的根目录,该目录里面的目录结构会被复制到输出目录。

--rootDirs:允许模块定位时,多个目录被当成一个虚拟目录。

--skipDefaultLibCheck:跳过 TypeScript 内置类型声明文件的类型检查。

--skipLibCheck:跳过.d.ts类型声明文件的类型检查。这样可以加快编译速度。

--showConfig:终端输出编译配置信息,而不进行配置。

--sourcemap:为编译产生的 JS 文件生成 SourceMap 文件(.map 文件)。

--sourceRoot:指定 SourceMap 文件里面的 TypeScript 源码根目录位置。

--strict:打开 TypeScript 严格检查模式。

--strictBindCallApply:bind, call、apply 这三个函数的类型,匹配原始函数。

--strictFunctionTypes:如果函数 B 的参数是函数 A 参数的子类型,那么函数 B 不能替代函数 A。

--strictNullChecks:对null和undefined进行严格类型检查。

--strictPropertyInitialization:类的属性必须进行初始值,但是允许在构造函数里面赋值。

--suppressExcessPropertyErrors:关闭对象字面量的多余参数的报错。

--target:指定编译出来的 JS 代码的版本,TypeScirpt 还会在编译时自动加入对应的库类型声明文件。

--traceResolution:编译时在终端输出模块解析(moduleResolution)的具体步骤。

--typeRoots:设置类型模块所在的目录,替代默认的node_modules/@types。

--types:设置typeRoots目录下需要包括在编译之中的类型模块。

--version:终端输出 tsc 的版本号。

--watch(或者-w):进入观察模式,只要文件有修改,就会自动重新编译。

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 160,026评论 4 364
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,655评论 1 296
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 109,726评论 0 244
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 44,204评论 0 213
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,558评论 3 287
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,731评论 1 222
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,944评论 2 314
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,698评论 0 203
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,438评论 1 246
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,633评论 2 247
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,125评论 1 260
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,444评论 3 255
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,137评论 3 238
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,103评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,888评论 0 197
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,772评论 2 276
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,669评论 2 271

推荐阅读更多精彩内容