Compiler Options
Option | Type | Default | Description |
---|---|---|---|
--allowJs |
boolean |
false |
允許JavaScript文件被編譯缺菌。 |
--allowSyntheticDefaultImports |
boolean |
module === "system" or --esModuleInterop is set and module is not es2015 /esnext
|
允許從沒有默認(rèn)導(dǎo)出的模塊進行默認(rèn)導(dǎo)入。這不會影響代碼運行伴郁,只是為了類型檢測狐胎。 |
--allowUnreachableCode |
boolean |
false |
不要報告無法訪問的代碼上的錯誤溅话。 |
--allowUnusedLabels |
boolean |
false |
不要在未使用的標(biāo)簽上報告錯誤屑墨。 |
--alwaysStrict |
boolean |
false |
在嚴(yán)格模式下解析并在每個文件內(nèi)添加"use strict"。 |
--baseUrl |
string |
用于解析非相對路徑模塊名稱的根目錄社痛,有關(guān)詳細(xì)信息撵儿,請參閱 [Module Resolution documentation](./Module Resolution.md#base-url) 牡直。 | |
--charset |
string |
"utf8" |
輸入文件的字符集饵史。 |
--checkJs |
boolean |
false |
報告.js文件中的錯誤厌蔽。與allowJs一起使用逾条。 |
--declaration -d
|
boolean |
false |
自動生成相應(yīng)的.d.ts文件。 |
--declarationDir |
string |
生成的聲明文件的輸出目錄挑豌。 | |
--declarationMap |
boolean |
false |
為每個對應(yīng)的“.d.ts”文件生成map文件。 |
--diagnostics |
boolean |
false |
顯示診斷信息。 |
--disableSizeLimit |
boolean |
false |
禁用JavaScript項目的大小限制赂摆。 |
--downlevelIteration |
boolean |
false |
提供迭代器全面支持篙耗。 |
--emitBOM |
boolean |
false |
在輸出文件的頭部添加UTF-8字節(jié)順序標(biāo)記(BOM)。 |
--emitDeclarationOnly |
boolean |
false |
僅添加'.d.ts'聲明文件逝嚎。 |
--emitDecoratorMetadata [1]
|
boolean |
false |
在源文件內(nèi)添加設(shè)計類型元數(shù)據(jù)硅堆。See issue #2577 for details. |
--esModuleInterop |
boolean |
false |
Emit __importStar and __importDefault helpers for runtime babel ecosystem compatibility and enable --allowSyntheticDefaultImports for typesystem compatibility. |
--experimentalDecorators [1]
|
boolean |
false |
為ES6的裝飾器啟用實驗支持哭廉。 |
--extendedDiagnostics |
boolean |
false |
顯示詳細(xì)的診斷信息。 |
--forceConsistentCasingInFileNames |
boolean |
false |
禁止對同一文件的不一致引用。 |
--help -h
|
打印幫助信息。 | ||
--importHelpers |
boolean |
false |
導(dǎo)入添加助手 (e.g. __extends , __rest , etc..) from tslib
|
--inlineSourceMap |
boolean |
false |
使用souce map生成單個文件,而不是使用單獨的文件。 |
--inlineSources |
boolean |
false |
在單獨的文件內(nèi)生成source吃沪。需要設(shè)置 --inlineSourceMap 或者 --sourceMap 。 |
--init |
初始化TypeScript項目并創(chuàng)建tsconfig.json文件。 | ||
--isolatedModules |
boolean |
false |
將每個文件透明化為單獨的模塊(類似于“ts.transpileModule”)噪服。 |
--jsx |
string |
"Preserve" |
在.tsx文件中支持JSX :"React"或"Preserve"。See JSX. |
--jsxFactory |
string |
"React.createElement" |
指定JSX工廠函數(shù)嬉愧,以便在定位反應(yīng)JSX發(fā)射時使用,例如React.createElement或h囱嫩。 |
--keyofStringsOnly |
boolean |
false |
僅解析keyof為字符串值屬性名稱(無數(shù)字或符號)乒裆。 |
--lib |
string[] |
要包含在編譯中的庫文件列表抛猖。 可能的值有: ? ES5 ? ES6 ? ES2015 ? ES7 ? ES2016 ? ES2017 ? ES2018 ? ESNext ? DOM ? DOM.Iterable ? WebWorker ? ScriptHost ? ES2015.Core ? ES2015.Collection ? ES2015.Generator ? ES2015.Iterable ? ES2015.Promise ? ES2015.Proxy ? ES2015.Reflect ? ES2015.Symbol ? ES2015.Symbol.WellKnown ? ES2016.Array.Include ? ES2017.object ? ES2017.Intl ? ES2017.SharedMemory ? ES2017.TypedArrays ? ES2018.Intl ? ES2018.Promise ? ES2018.RegExp ? ESNext.AsyncIterable ? ESNext.Array ? ESNext.Intl ? ESNext.Symbol 注意:如果--lib未指定庫的默認(rèn)列表注入格侯。注入的默認(rèn)庫包括: ? For --target ES5 : DOM,ES5,ScriptHost ? For --target ES6 : DOM,ES6,DOM.Iterable,ScriptHost
|
|
--listEmittedFiles |
boolean |
false |
打印編譯的部分生成文件的名稱。 |
--listFiles |
boolean |
false |
打印編譯部分文件的名稱财著。 |
--locale |
string |
(platform specific) | 用于顯示錯誤消息的語言環(huán)境联四,例如en-us。 可能的值包括: ? English (US): en ? Czech: cs ? German: de ? Spanish: es ? French: fr ? Italian: it ? Japanese: ja ? Korean: ko ? Polish: pl ? Portuguese(Brazil): pt-BR ? Russian: ru ? Turkish: tr ? Simplified Chinese: zh-CN ? Traditional Chinese: zh-TW
|
--mapRoot |
string |
指定調(diào)試器應(yīng)該找到映射文件而不是生成的位置的位置撑教。如果.map文件將在運行時位于與.js文件不同的位置朝墩,請使用此標(biāo)志。指定的位置將嵌入到sourceMap中伟姐,以指示調(diào)試器將映射文件所在的位置收苏。 | |
--maxNodeModuleJsDepth |
number |
0 |
在node_modules下搜索并加載JavaScript文件的最大依賴關(guān)系深度。僅適用于--allowJs愤兵。 |
--module -m
|
string |
target === "ES3" or "ES5" ? "CommonJS" : "ES6" |
指定模塊代碼生成:"None"鹿霸,"CommonJS","AMD"秆乳,"System"懦鼠,"UMD"钻哩,"ES6","ES2015"或"ESNext"肛冶。 ? 僅"AMD"和"System"可以一起使用--outFile街氢。 ? 當(dāng)目標(biāo)編譯 "ES5" 或者更低時可能使用"ES6" 和 "ES2015"
|
--moduleResolution |
string |
module === "AMD" or "System" or "ES6" ? "Classic" : "Node" |
確定如何解決模塊。無論是"Node"使用Node.js語言/ io.js風(fēng)格的分辨率睦袖,或"Classic"珊肃。有關(guān)詳細(xì)信息,請參閱[Module Resolution documentation](./Module Resolution.md) |
--newLine |
string |
(platform specific) | 使用發(fā)出文件時指定的行結(jié)束序列:( "crlf"windows)或"lf"(unix)馅笙÷浊牵“ |
--noEmit |
boolean |
false |
不生成文件 |
--noEmitHelpers |
boolean |
false |
不在已生成的文件里生成類似__extends 的自定義工具庫 |
--noEmitOnError |
boolean |
false |
如果報告任何錯誤,不生成文件延蟹。 |
--noErrorTruncation |
boolean |
false |
不截斷錯誤消息评矩。 |
--noFallthroughCasesInSwitch |
boolean |
false |
報告switch語句中的fallthrough案例的錯誤。 |
--noImplicitAny |
boolean |
false |
使用隱含any類型提高表達式和聲明的錯誤阱飘。 |
--noImplicitReturns |
boolean |
false |
當(dāng)函數(shù)中的所有代碼路徑都沒有返回值時報告錯誤。 |
--noImplicitThis |
boolean |
false |
this使用隱含any類型時提示錯誤虱颗。 |
--noImplicitUseStrict |
boolean |
false |
不在輸出模塊上生成"use strict" 沥匈。 |
--noLib |
boolean |
false |
不要包含默認(rèn)庫文件(lib.d.ts )。 |
--noResolve |
boolean |
false |
不要將三斜杠引用或模塊導(dǎo)入目標(biāo)添加到已編譯文件列表中忘渔。 |
--noStrictGenericChecks |
boolean |
false |
禁止嚴(yán)格檢查函數(shù)類型中的通用簽名高帖。 |
--noUnusedLocals |
boolean |
false |
報告未使用的局部變量的錯誤。 |
--noUnusedParameters |
boolean |
false |
報告未使用參數(shù)的錯誤畦粮。 |
--out |
string |
被移除DEPRECATED. 請使用--outFile代替散址。 | |
--outDir |
string |
將輸出結(jié)構(gòu)重定向到目錄。 | |
--outFile |
string |
連接并將輸出提交到單個文件宣赔。連接的順序由在命令行上傳遞給編譯器的文件列表以及三斜杠引用和導(dǎo)入確定预麸。有關(guān)詳細(xì)信息,請參閱輸出文件順序文檔儒将。 | |
paths [2]
|
Object |
模塊名稱到相對于的位置的路徑映射條目列表baseUrl吏祸。有關(guān)詳細(xì)信息,請參閱[Module Resolution documentation](./Module Resolution.md#path-mapping) 钩蚊。 | |
--preserveConstEnums |
boolean |
false |
不要在生成的代碼中刪除const枚舉聲明贡翘。有關(guān)更多詳細(xì)信息,請參閱 [const enums documentation]砰逻。(https://github.com/Microsoft/TypeScript/blob/master/doc/spec.md#94-constant-enum-declarations) for more details. |
--preserveSymlinks |
boolean |
false |
不要將符號鏈接解析為真正的路徑; 將符號鏈接的文件視為真實文件鸣驱。 |
--preserveWatchOutput |
boolean |
false |
在監(jiān)視模式下保持過時的控制臺輸出,而不是清除屏幕蝠咆。 |
--pretty |
boolean |
使用顏色和上下文來設(shè)置錯誤和消息的樣式踊东。 | |
--project -p
|
string |
在給定有效配置文件的情況下編譯項目。 參數(shù)可以是有效JSON配置文件的文件路徑,也可以是包含文件的目錄的目錄路徑tsconfig.json递胧。 有關(guān)更多詳細(xì)信息碑韵,請參閱 tsconfig.json 。 |
|
--reactNamespace |
string |
"React" |
DEPRECATED. 使用--jsxFactory代替缎脾。 |
--removeComments |
boolean |
false |
刪除所有注釋祝闻,除了以右側(cè)開頭的副本標(biāo)題注釋 /*! |
--resolveJsonModule |
boolean |
false |
包含使用.json擴展名導(dǎo)入的模塊。 |
--rootDir |
string |
指定輸入文件的根目錄遗菠。僅用于控制輸出目錄結(jié)構(gòu)--outDir联喘。 | |
rootDirs [2]
|
string[] |
根文件夾列表,其組合內(nèi)容表示運行時項目的結(jié)構(gòu)辙纬。See [Module Resolution documentation](./Module Resolution.md#virtual-directories-with-rootdirs) for more details. | |
--skipDefaultLibCheck |
boolean |
false |
DEPRECATED.使用--skipLibCheck代替豁遭。 Skip type checking of [default library declaration files](./Triple-Slash Directives.md#-reference-no-default-libtrue). |
--skipLibCheck |
boolean |
false |
跳過所有聲明文件的類型檢查(*.d.ts)。 |
--sourceMap |
boolean |
false |
生成相應(yīng)的.map文件贺拣。 |
--sourceRoot |
string |
指定調(diào)試器應(yīng)該找到TypeScript文件而不是源位置的位置蓖谢。如果源位于運行時位于與設(shè)計時不同的位置,請使用此標(biāo)志譬涡。指定的位置將嵌入到sourceMap中闪幽,以指示源文件所在的調(diào)試器。 | |
--strict |
boolean |
false |
啟用所有嚴(yán)格類型檢查選項涡匀。--strict 啟用 --noImplicitAny , --noImplicitThis , --alwaysStrict , --strictNullChecks , --strictFunctionTypes 和 --strictPropertyInitialization 盯腌。 |
--strictFunctionTypes |
boolean |
false |
禁用功能類型的雙變量參數(shù)檢查。 |
--strictPropertyInitialization |
boolean |
false |
確保在構(gòu)造函數(shù)中初始化非未定義的類屬性陨瘩。需要--strictNullChecks啟用此選項才能生效腕够。 |
--strictNullChecks |
boolean |
false |
在嚴(yán)格的空檢查模式中,null和undefined值不在每種類型的域中舌劳,并且只能分配給它們any(undefined可以分配的一個例外void)帚湘。 |
--stripInternal [1]
|
boolean |
false |
不要為具有/** @internal */JSDoc注釋的代碼發(fā)出聲明。 |
--suppressExcessPropertyErrors |
boolean |
false |
禁止對象文字的多余屬性檢查蒿囤。 |
--suppressImplicitAnyIndexErrors |
boolean |
false |
抑制--noImplicitAny 索引缺少索引簽名的對象的錯誤客们。有關(guān)詳細(xì)信息,請參閱問題#1232材诽。 |
--target -t
|
string |
"ES3" |
指定ECMAScript的目標(biāo)版本:"ES3"(默認(rèn))底挫, "ES5","ES6"/ "ES2015"脸侥,"ES2016"建邓,"ES2017"或"ESNext"。 注意: "ESNext" 目標(biāo)是最新支持的ES提議功能睁枕。 |
--traceResolution |
boolean |
false |
報告模塊解析日志消息官边。 |
--types |
string[] |
要包括的類型定義的名稱列表沸手。有關(guān)詳細(xì)信息,請參閱@types注簿,-typeRoots和-types契吉。 | |
--typeRoots |
string[] |
要包含類型定義的文件夾列表。有關(guān)詳細(xì)信息诡渴,請參閱@types捐晶,-typeRoots和-types。 | |
--version -v
|
打印編譯器的版本妄辩。 | ||
--watch -w
|
在監(jiān)視模式下運行編譯器惑灵。觀察輸入文件并在更改時觸發(fā)重新編譯⊙垡可以使用環(huán)境變量配置觀察文件和目錄的實現(xiàn)英支。有關(guān)詳細(xì)信息,請參閱配置監(jiān)視 |
- [1] 這些選項是實驗性的哮伟。
- [2] 這些選項僅允許使用tsconfig.json干花,而不能通過命令行開關(guān)。
Related
- 在
tsconfig.json
文件中設(shè)置編譯器選項澈吨。 - 在MSBuild項目中設(shè)置編譯器選項把敢。