一 tsconfig.json文件是編譯typeScript語言時遵循的編譯規則配置:
在TS的項目中,TS最終都會被編譯JS文件執行,TS編譯器在編譯TS文件的時候都會先在項目根目錄的
tsconfig.json
文件,根據該文件的配置進行編譯,默認情況下,如果該文件沒有任何配置,TS編譯器會默認編譯項目目錄下所有的
.ts、.tsx、.d.ts
文件。實際項目中,會根據自己的需求進行自定義的配置,下面就來詳細了解下
tsconfig.json
的文件配置
{ "compilerOptions": { /* Basic Options */ "target": "es5" /* target用於指定編譯之后的版本目標: 'ES3' (default), 'ES5', 'ES2015', 'ES2016', 'ES2017', 'ES2018', 'ES2019' or 'ESNEXT'. */, "module": "commonjs" /* 用來指定要使用的模塊標准: 'none', 'commonjs', 'amd', 'system', 'umd', 'es2015', or 'ESNext'. */, "lib": ["es6", "dom"] /* lib用於指定要包含在編譯中的庫文件 */, "allowJs": true, /* allowJs設置的值為true或false,用來指定是否允許編譯js文件,默認是false,即不編譯js文件 */ "checkJs": true, /* checkJs的值為true或false,用來指定是否檢查和報告js文件中的錯誤,默認是false */ "jsx": "preserve", /* 指定jsx代碼用於的開發環境: 'preserve', 'react-native', or 'react'. */ "declaration": true, /* declaration的值為true或false,用來指定是否在編譯的時候生成相應的".d.ts"聲明文件。如果設為true,編譯每個ts文件之后會生成一個js文件和一個聲明文件。但是declaration和allowJs不能同時設為true */ "declarationMap": true, /* 值為true或false,指定是否為聲明文件.d.ts生成map文件 */ "sourceMap": true, /* sourceMap的值為true或false,用來指定編譯時是否生成.map文件 */ "outFile": "./", /* outFile用於指定將輸出文件合並為一個文件,它的值為一個文件路徑名。比如設置為"./dist/main.js",則輸出的文件為一個main.js文件。但是要注意,只有設置module的值為amd和system模塊時才支持這個配置 */ "outDir": "./", /* outDir用來指定輸出文件夾,值為一個文件夾路徑字符串,輸出的文件都將放置在這個文件夾 */ "rootDir": "./", /* 用來指定編譯文件的根目錄,編譯器會在根目錄查找入口文件,如果編譯器發現以rootDir的值作為根目錄查找入口文件並不會把所有文件加載進去的話會報錯,但是不會停止編譯 */ "composite": true, /* 是否編譯構建引用項目 */ "incremental": true, /* 是否啟用增量編譯*/ "tsBuildInfoFile": "./", /* 指定文件用來存儲增量編譯信息 */ "removeComments": true, /* removeComments的值為true或false,用於指定是否將編譯后的文件中的注釋刪掉,設為true的話即刪掉注釋,默認為false */ "noEmit": true, /* 不生成編譯文件,這個一般比較少用 */ "importHelpers": true, /* importHelpers的值為true或false,指定是否引入tslib里的輔助工具函數,默認為false */ "downlevelIteration": true, /* 當target為'ES5' or 'ES3'時,為'for-of', spread, and destructuring'中的迭代器提供完全支持 */ "isolatedModules": true, /* isolatedModules的值為true或false,指定是否將每個文件作為單獨的模塊,默認為true,它不可以和declaration同時設定 */ /* Strict Type-Checking Options */ "strict": true /* strict的值為true或false,用於指定是否啟動所有類型檢查,如果設為true則會同時開啟下面這幾個嚴格類型檢查,默認為false */, "noImplicitAny": true, /* noImplicitAny的值為true或false,如果我們沒有為一些值設置明確的類型,編譯器會默認認為這個值為any,如果noImplicitAny的值為true的話。則沒有明確的類型會報錯。默認值為false */ "strictNullChecks": true, /* strictNullChecks為true時,null和undefined值不能賦給非這兩種類型的值,別的類型也不能賦給他們,除了any類型。還有個例外就是undefined可以賦值給void類型 */ "strictFunctionTypes": true, /* strictFunctionTypes的值為true或false,用於指定是否使用函數參數雙向協變檢查 */ "strictBindCallApply": true, /* 設為true后會對bind、call和apply綁定的方法的參數的檢測是嚴格檢測的 */ "strictPropertyInitialization": true, /* 設為true后會檢查類的非undefined屬性是否已經在構造函數里初始化,如果要開啟這項,需要同時開啟strictNullChecks,默認為false */ "noImplicitThis": true, /* 當this表達式的值為any類型的時候,生成一個錯誤 */ "alwaysStrict": true, /* alwaysStrict的值為true或false,指定始終以嚴格模式檢查每個模塊,並且在編譯之后的js文件中加入"use strict"字符串,用來告訴瀏覽器該js為嚴格模式 */ /* Additional Checks */ "noUnusedLocals": true, /* 用於檢查是否有定義了但是沒有使用的變量,對於這一點的檢測,使用eslint可以在你書寫代碼的時候做提示,你可以配合使用。它的默認值為false */ "noUnusedParameters": true, /* 用於檢查是否有在函數體中沒有使用的參數,這個也可以配合eslint來做檢查,默認為false */ "noImplicitReturns": true, /* 用於檢查函數是否有返回值,設為true后,如果函數沒有返回值則會提示,默認為false */ "noFallthroughCasesInSwitch": true, /* 用於檢查switch中是否有case沒有使用break跳出switch,默認為false */ /* Module Resolution Options */ "moduleResolution": "node", /* 用於選擇模塊解析策略,有'node'和'classic'兩種類型' */ "baseUrl": "./", /* baseUrl用於設置解析非相對模塊名稱的基本目錄,相對模塊不會受baseUrl的影響 */ "paths": {}, /* 用於設置模塊名稱到基於baseUrl的路徑映射 */ "rootDirs": [], /* rootDirs可以指定一個路徑列表,在構建時編譯器會將這個路徑列表中的路徑的內容都放到一個文件夾中 */ "typeRoots": [], /* typeRoots用來指定聲明文件或文件夾的路徑列表,如果指定了此項,則只有在這里列出的聲明文件才會被加載 */ "types": [], /* types用來指定需要包含的模塊,只有在這里列出的模塊的聲明文件才會被加載進來 */ "allowSyntheticDefaultImports": true, /* 用來指定允許從沒有默認導出的模塊中默認導入 */ "esModuleInterop": true /* 通過為導入內容創建命名空間,實現CommonJS和ES模塊之間的互操作性 */, "preserveSymlinks": true, /* 不把符號鏈接解析為其真實路徑,具體可以了解下webpack和nodejs的symlink相關知識 */ /* Source Map Options */ "sourceRoot": "", /* sourceRoot用於指定調試器應該找到TypeScript文件而不是源文件位置,這個值會被寫進.map文件里 */ "mapRoot": "", /* mapRoot用於指定調試器找到映射文件而非生成文件的位置,指定map文件的根路徑,該選項會影響.map文件中的sources屬性 */ "inlineSourceMap": true, /* 指定是否將map文件的內容和js文件編譯在同一個js文件中,如果設為true,則map的內容會以//# sourceMappingURL=然后拼接base64字符串的形式插入在js文件底部 */ "inlineSources": true, /* 用於指定是否進一步將.ts文件的內容也包含到輸入文件中 */ /* Experimental Options */ "experimentalDecorators": true /* 用於指定是否啟用實驗性的裝飾器特性 */ "emitDecoratorMetadata": true, /* 用於指定是否為裝飾器提供元數據支持,關於元數據,也是ES6的新標准,可以通過Reflect提供的靜態方法獲取元數據,如果需要使用Reflect的一些方法,需要引入ES2015.Reflect這個庫 */ } "files": [], // files可以配置一個數組列表,里面包含指定文件的相對或絕對路徑,編譯器在編譯的時候只會編譯包含在files中列出的文件,如果不指定,則取決於有沒有設置include選項,如果沒有include選項,則默認會編譯根目錄以及所有子目錄中的文件。這里列出的路徑必須是指定文件,而不是某個文件夾,而且不能使用* ? **/ 等通配符 "include": [], // include也可以指定要編譯的路徑列表,但是和files的區別在於,這里的路徑可以是文件夾,也可以是文件,可以使用相對和絕對路徑,而且可以使用通配符,比如"./src"即表示要編譯src文件夾下的所有文件以及子文件夾的文件 "exclude": [], // exclude表示要排除的、不編譯的文件,它也可以指定一個列表,規則和include一樣,可以是文件或文件夾,可以是相對路徑或絕對路徑,可以使用通配符 "extends": "", // extends可以通過指定一個其他的tsconfig.json文件路徑,來繼承這個配置文件里的配置,繼承來的文件的配置會覆蓋當前文件定義的配置。TS在3.2版本開始,支持繼承一個來自Node.js包的tsconfig.json配置文件 "compileOnSave": true, // compileOnSave的值是true或false,如果設為true,在我們編輯了項目中的文件保存的時候,編輯器會根據tsconfig.json中的配置重新生成文件,不過這個要編輯器支持 "references": [], // 一個對象數組,指定要引用的項目 }
二 tslint配置
tslint.json是對typescript規范進行檢驗的文件。https://palantir.github.io/tslint/
查看全局安裝npm包cli:npm list -g --depth 0
參考鏈接:
tsconfig配置:https://www.jianshu.com/p/47c29865b3a4
typescript官方文檔:https://www.typescriptlang.org/