tsconfig.json
概述
目錄中存在 tsconfig.json 檔案表示該目錄是 TypeScript 專案的根目錄。tsconfig.json 檔案指定編譯專案所需的根檔案和編譯器選項。
使用 tsconfig.json
- 通過在沒有輸入檔案的情況下呼叫 tsc,在這種情況下,編譯器將從當前目錄開始搜尋 tsconfig.json 檔案並繼續執行父目錄鏈。
- 通過呼叫沒有輸入檔案的 tsc 和 –project(或只是 -p)命令列選項來指定包含 tsconfig.json 檔案的目錄的路徑。在命令列上指定輸入檔案時,tsconfig.json 檔案是
細節
可以省略 compilerOptions
屬性,在這種情況下使用編譯器的預設值。請參閱支援的編譯器選項的完整列表。
如果 tsconfig.json 中不存在 files
屬性,則編譯器預設包含所包含目錄和子目錄中的所有 TypeScript(* .ts 或* .tsx)檔案。當存在 files
屬性時,僅包含指定的檔案。
如果指定了 exclude
屬性,則編譯器將包含所有包含目錄和子目錄中的 TypeScript(* .ts 或* .tsx)檔案,但排除這些檔案或資料夾除外。
files
屬性不能與 exclude
屬性一起使用。如果兩者都指定,則 files
屬性優先。
還包括 files
屬性中指定的任何檔案。類似地,如果檔案 B.ts 被另一個檔案 A.ts 引用,則除非在 exclude
列表中也指定了引用檔案 A.ts,否則不能排除 B.ts。
允許 tsconfig.json
檔案完全為空,它使用預設編譯器選項編譯包含目錄和子目錄中的所有檔案。
命令列中指定的編譯器選項會覆蓋 tsconfig.json 檔案中指定的那些選項。
架構
架構可以在 http://json.schemastore.org/tsconfig 找到