TypeScript学习笔记（三）—— 编译选项、声明文件、WebPack打包、Babel转换

安志林 發表於 2022-9-26 14:57:00

TypeScript学习笔记（三）—— 编译选项、声明文件、WebPack打包、Babel转换

<h1 class="md-end-block md-heading">一、编译选项与配置文件</h1>
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
自动编译文件
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
编译文件时，使用 -w 指令后，TS编译器会自动监视文件的变化，并在文件发生变化时对文件进行重新编译。
</li>
<li class="md-list-item">
示例：
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
<pre class="md-fences md-end-block ty-contain-cm modeLoaded">tsc xxx.ts -w</pre>
</li>
</ul>
</li>
</ul>
</li>
<li class="md-list-item">
自动编译整个项目 
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
如果直接使用tsc指令，则可以自动将当前项目下的所有ts文件编译为js文件。
</li>
<li class="md-list-item">
但是能直接使用tsc命令的前提时，要先在项目根目录下创建一个ts的配置文件 tsconfig.json
</li>
<li class="md-list-item">
tsconfig.json是一个JSON文件，添加配置文件后，只需只需 tsc 命令即可完成对整个项目的编译
</li>
<li class="md-list-item">
配置选项：
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
include
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
定义希望被编译文件所在的目录
</li>
<li class="md-list-item">
默认值：["**/*"]
</li>
<li class="md-list-item">
示例：
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
<pre class="md-fences md-end-block ty-contain-cm modeLoaded">"include":["src/**/*", "tests/**/*"]</pre>
</li>
<li class="md-list-item">
上述示例中，所有src目录和tests目录下的文件都会被编译
</li>
</ul>
</li>
</ul>
</li>
<li class="md-list-item">
exclude
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
定义需要排除在外的目录
</li>
<li class="md-list-item">
默认值：["node_modules", "bower_components", "jspm_packages"]
</li>
<li class="md-list-item">
示例：
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
<pre class="md-fences md-end-block ty-contain-cm modeLoaded">"exclude": ["./src/hello/**/*"]</pre>
</li>
<li class="md-list-item">
上述示例中，src下hello目录下的文件都不会被编译
</li>
</ul>
</li>
</ul>
</li>
<li class="md-list-item">
extends
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
定义被继承的配置文件
</li>
<li class="md-list-item">
示例：
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
<pre class="md-fences md-end-block ty-contain-cm modeLoaded">"extends": "./configs/base"</pre>
</li>
<li class="md-list-item">
上述示例中，当前配置文件中会自动包含config目录下base.json中的所有配置信息
</li>
</ul>
</li>
</ul>
</li>
<li class="md-list-item">
files
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
指定被编译文件的列表，只有需要编译的文件少时才会用到
</li>
<li class="md-list-item">
示例：
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
<pre class="md-fences md-end-block ty-contain-cm modeLoaded">"files": [    "core.ts",    "sys.ts",    "types.ts",    "scanner.ts",    "parser.ts",    "utilities.ts",    "binder.ts",    "checker.ts",    "tsc.ts" ]</pre>
</li>
<li class="md-list-item">
列表中的文件都会被TS编译器所编译
</li>
</ul>
</li>
<li class="md-list-item">
compilerOptions
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
编译选项是配置文件中非常重要也比较复杂的配置选项
</li>
<li class="md-list-item">
在compilerOptions中包含多个子选项，用来完成对编译的配置
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
项目选项
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
target
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
设置ts代码编译的目标版本
</li>
<li class="md-list-item">
可选值：
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
ES3（默认）、ES5、ES6/ES2015、ES7/ES2016、ES2017、ES2018、ES2019、ES2020、ESNext
</li>
</ul>
</li>
<li class="md-list-item">
示例：
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
<pre class="md-fences md-end-block ty-contain-cm modeLoaded">"compilerOptions": {    "target": "ES6" }</pre>
</li>
<li class="md-list-item">
如上设置，我们所编写的ts代码将会被编译为ES6版本的js代码
</li>
</ul>
</li>
</ul>
</li>
<li class="md-list-item">
lib
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
指定代码运行时所包含的库（宿主环境）
</li>
<li class="md-list-item">
可选值：
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
ES5、ES6/ES2015、ES7/ES2016、ES2017、ES2018、ES2019、ES2020、ESNext、DOM、WebWorker、ScriptHost ......
</li>
</ul>
</li>
<li class="md-list-item">
示例：
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
<pre class="md-fences md-end-block ty-contain-cm modeLoaded">"compilerOptions": {    "target": "ES6",    "lib": ["ES6", "DOM"],    "outDir": "dist",    "outFile": "dist/aa.js" }</pre>
</li>
</ul>
</li>
</ul>
</li>
<li class="md-list-item">
module
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
设置编译后代码使用的模块化系统
</li>
<li class="md-list-item">
可选值：
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
CommonJS、UMD、AMD、System、ES2020、ESNext、None
</li>
</ul>
</li>
<li class="md-list-item">
示例：
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
<pre class="md-fences md-end-block ty-contain-cm modeLoaded">"compilerOptions": {    "module": "CommonJS" }</pre>
</li>
</ul>
</li>
</ul>
</li>
<li class="md-list-item">
outDir
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
编译后文件的所在目录
</li>
<li class="md-list-item">
默认情况下，编译后的js文件会和ts文件位于相同的目录，设置outDir后可以改变编译后文件的位置
</li>
<li class="md-list-item">
示例：
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
<pre class="md-fences md-end-block ty-contain-cm modeLoaded">"compilerOptions": {    "outDir": "dist" }</pre>
</li>
<li class="md-list-item">
设置后编译后的js文件将会生成到dist目录
</li>
</ul>
</li>
</ul>
</li>
<li class="md-list-item">
outFile
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
将所有的文件编译为一个js文件
</li>
<li class="md-list-item">
默认会将所有的编写在全局作用域中的代码合并为一个js文件，如果module制定了None、System或AMD则会将模块一起合并到文件之中
</li>
<li class="md-list-item">
示例：
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
<pre class="md-fences md-end-block ty-contain-cm modeLoaded">"compilerOptions": {    "outFile": "dist/app.js" }</pre>
</li>
</ul>
</li>
</ul>
</li>
<li class="md-list-item">
rootDir
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
指定代码的根目录，默认情况下编译后文件的目录结构会以最长的公共目录为根目录，通过rootDir可以手动指定根目录
</li>
<li class="md-list-item">
示例：
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
<pre class="md-fences md-end-block ty-contain-cm modeLoaded">"compilerOptions": {    "rootDir": "./src" }</pre>
</li>
</ul>
</li>
</ul>
</li>
<li class="md-list-item">
allowJs
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
是否对js文件编译
</li>
</ul>
</li>
<li class="md-list-item">
checkJs
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
是否对js文件进行检查
</li>
<li class="md-list-item">
示例：
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
<pre class="md-fences md-end-block ty-contain-cm modeLoaded">"compilerOptions": {    "allowJs": true,    "checkJs": true }</pre>
</li>
</ul>
</li>
</ul>
</li>
<li class="md-list-item">
removeComments
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
是否删除注释
</li>
<li class="md-list-item">
默认值：false
</li>
</ul>
</li>
<li class="md-list-item">
noEmit
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
不对代码进行编译
</li>
<li class="md-list-item">
默认值：false
</li>
</ul>
</li>
<li class="md-list-item">
sourceMap
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
是否生成sourceMap
</li>
<li class="md-list-item">
默认值：false
</li>
</ul>
 
</li>
</ul>
</li>
<li class="md-list-item">
严格检查
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
strict
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
启用所有的严格检查，默认值为true，设置后相当于开启了所有的严格检查
</li>
</ul>
</li>
<li class="md-list-item">
alwaysStrict
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
总是以严格模式对代码进行编译
</li>
</ul>
</li>
<li class="md-list-item">
noImplicitAny
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
禁止隐式的any类型
</li>
<li class="md-list-item">
<code>noImplicitAny</code>编译器选项所做的，基本上是将TypeScript从可选类型语言转换为强制类型检验语言。这使得TypeScript离JavaScript的超集稍微远了一些，因为简单的：
<pre class="javascript hljs language-javascript">function logMe(x) {
console.log(x);
}
// error TS7006: Parameter 'x' implicitly has an 'any' type.</pre>
也将报错——你必须明确声明<code>x</code>的类型为<code>any</code>:
<pre class="javascript hljs language-javascript">function logMe(x: any) {
console.log(x);
}
// OK</pre>
</li>
</ul>
</li>
<li class="md-list-item">
noImplicitThis
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
禁止类型不明确的this
</li>
</ul>
</li>
<li class="md-list-item">
strictBindCallApply
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
严格检查bind、call和apply的参数列表
</li>
</ul>
</li>
<li class="md-list-item">
strictFunctionTypes
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
严格检查函数的类型
</li>
</ul>
</li>
<li class="md-list-item">
strictNullChecks
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
严格的空值检查
</li>
</ul>
</li>
<li class="md-list-item">
strictPropertyInitialization
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
严格检查属性是否初始化
</li>
</ul>
</li>
</ul>
</li>
<li class="md-list-item">
额外检查
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
noFallthroughCasesInSwitch
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
检查switch语句包含正确的break
</li>
</ul>
</li>
<li class="md-list-item">
noImplicitReturns
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
检查函数没有隐式的返回值
</li>
</ul>
</li>
<li class="md-list-item">
noUnusedLocals
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
检查未使用的局部变量
</li>
</ul>
</li>
<li class="md-list-item">
noUnusedParameters
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
检查未使用的参数
</li>
</ul>
</li>
</ul>
</li>
<li class="md-list-item">
高级
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
allowUnreachableCode
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
检查不可达代码
</li>
<li class="md-list-item">
可选值：
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
true，忽略不可达代码
</li>
<li class="md-list-item">
false，不可达代码将引起错误
</li>
</ul>
</li>
</ul>
</li>
<li class="md-list-item">
noEmitOnError
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
有错误的情况下不进行编译
</li>
<li class="md-list-item md-focus-container">
默认值：false
</li>
</ul>
</li>
</ul>
</li>
</ul>
</li>
</ul>
</li>
</ul>
</li>
</ul>
</li>
</ul>
</li>
</ul>
<h2>1.0、生成tsconfig.json文件</h2>
在目录下使用<code>tsc --init</code> 生成<code>tsconfig.json</code>文件
<img src="https://img2022.cnblogs.com/blog/63651/202209/63651-20220926141235049-814992013.png" alt="" loading="lazy">
<h2>1.1、tsconfig.json 的作⽤</h2>
<ul>
<li>⽤于标识 TypeScript 项⽬的根路径；</li>
<li>⽤于配置 TypeScript 编译器；</li>
<li>⽤于指定编译的⽂件。</li>
</ul>
<h2 id="tsconfigjson-重要字段">1.2、tsconfig.json 重要字段</h2>
<ul>
<li>files - 设置要编译的⽂件的名称；</li>
<li>include - 设置需要进⾏编译的⽂件，⽀持路径模式匹配；</li>
<li>exclude - 设置⽆需进⾏编译的⽂件，⽀持路径模式匹配；</li>
<li>compilerOptions - 设置与编译流程相关的选项。</li>
</ul>
使用<code>"files"</code>属性
<div class="cnblogs_code">
<pre>{
"compilerOptions": {
 "module": "commonjs",
 "noImplicitAny": true,
 "removeComments": true,
 "preserveConstEnums": true,
 "sourceMap": true
},
"files": [
 "core.ts",
 "sys.ts",
 "types.ts",
 "scanner.ts",
 "parser.ts",
 "utilities.ts",
 "binder.ts",
 "checker.ts",
 "emitter.ts",
 "program.ts",
 "commandLineParser.ts",
 "tsc.ts",
 "diagnosticInformationMap.generated.ts"
]
}</pre>
</div>
使用<code>"include"</code>和<code>"exclude"</code>属性
<div class="cnblogs_code">
<pre>{
"compilerOptions": {
 "module": "system",
 "noImplicitAny": true,
 "removeComments": true,
 "preserveConstEnums": true,
 "outFile": "../../built/local/tsc.js",
 "sourceMap": true
},
"include": [
 "src/**/*"
],
"exclude": [
 "node_modules",
 "**/*.spec.ts"
]
}</pre>
</div>
<h2 id="compileroptions-选项">1.3、compilerOptions 选项</h2>
compilerOptions ⽀持很多选项，常⻅的有 <code>baseUrl</code> 、 <code>target</code> 、 <code>moduleResolution</code> 和 <code>lib</code> 等。 compilerOptions 每个选项的详细说明如下：
<div class="cnblogs_code">
<pre>{
"compilerOptions": {
/* 基本选项 */
"target": "es5", // 指定 ECMAScript ⽬标版本: 'ES3'(default), 'ES5', 'ES6'/'ES2015', 'ES2016', 'ES2017', or 'ESNEXT'
"module": "commonjs", // 指定使⽤模块: 'commonjs', 'amd','system', 'umd' or 'es2015'
"lib": [], // 指定要包含在编译中的库⽂件
"allowJs": true, // 允许编译 javascript ⽂件
"checkJs": true, // 报告 javascript ⽂件中的错误
"jsx": "preserve", // 指定 jsx 代码的⽣成: 'preserve','react-native', or 'react'
"declaration": true, // ⽣成相应的 '.d.ts' ⽂件
"sourceMap": true, // ⽣成相应的 '.map' ⽂件
"outFile": "./", // 将输出⽂件合并为⼀个⽂件
"outDir": "./", // 指定输出⽬录
"rootDir": "./", // ⽤来控制输出⽬录结构 --outDir.
"removeComments": true, // 删除编译后的所有的注释
"noEmit": true, // 不⽣成输出⽂件
"importHelpers": true, // 从 tslib 导⼊辅助⼯具函数
"isolatedModules": true, // 将每个⽂件做为单独的模块（与'ts.transpileModule' 类似）.
/* 严格的类型检查选项 */
"strict": true, // 启⽤所有严格类型检查选项
"noImplicitAny": true, // 在表达式和声明上有隐含的 any类型时报错
"strictNullChecks": true, // 启⽤严格的 null 检查
"noImplicitThis": true, // 当 this 表达式值为 any 类型的时候，⽣成⼀个错误
"alwaysStrict": true, // 以严格模式检查每个模块，并在每个⽂件⾥加
⼊ 'use strict'
/* 额外的检查 */
"noUnusedLocals": true, // 有未使⽤的变量时，抛出错误
"noUnusedParameters": true, // 有未使⽤的参数时，抛出错误
"noImplicitReturns": true, // 并不是所有函数⾥的代码都有返回值时，抛出错误
"noFallthroughCasesInSwitch": true, // 报告 switch 语句的 fallthrough 错误。（即，不允许 switch 的 case 语句贯穿）
/* 模块解析选项 */
"moduleResolution": "node", // 选择模块解析策略： 'node' (Node.js)
or 'classic' (TypeScript pre-1.6)
"baseUrl": "./", // ⽤于解析⾮相对模块名称的基⽬录
"paths": {}, // 模块名到基于 baseUrl 的路径映射的列表
"rootDirs": [], // 根⽂件夹列表，其组合内容表示项⽬运⾏时的结构内容
"typeRoots": [], // 包含类型声明的⽂件列表
"types": [], // 需要包含的类型声明⽂件名列表
"allowSyntheticDefaultImports": true, // 允许从没有设置默认导出的模块中默认导⼊。
/* Source Map Options */
"sourceRoot": "./", // 指定调试器应该找到 TypeScript ⽂件⽽不是源⽂件的位置
"mapRoot": "./", // 指定调试器应该找到映射⽂件⽽不是⽣成⽂件的位置
"inlineSourceMap": true, // ⽣成单个 soucemaps ⽂件，⽽不是将sourcemaps ⽣成不同的⽂件
"inlineSources": true, // 将代码与 sourcemaps ⽣成到⼀个⽂件中，要求同时设置了 --inlineSourceMap 或 --sourceMap 属性
/* 其他选项 */
"experimentalDecorators": true, // 启⽤装饰器
"emitDecoratorMetadata": true // 为装饰器提供元数据的⽀持
}
}</pre>
</div>
<div class="cnblogs_code">
<pre>这个文件是一个TypeScript配置文件（`tsconfig.json`），用于配置TypeScript编译器的行为。这个文件通常位于TypeScript项目的根目录下，用于指定编译选项和项目设置。下面是对文件中各个配置项的解释：

### 项目选项（Projects）
- `incremental`: 启用增量编译，保存`.tsbuildinfo`文件以允许项目增量编译。
- `composite`: 启用约束，允许TypeScript项目与项目引用一起使用。
- `tsBuildInfoFile`: 指定`.tsbuildinfo`增量编译文件的路径。
- `disableSourceOfProjectReferenceRedirect`: 禁止在引用复合项目时优先使用源文件而不是声明文件。
- `disableSolutionSearching`: 编辑时选择退出多项目引用检查。
- `disableReferencedProjectLoad`: 减少TypeScript自动加载的项目数量。

### 语言和环境（Language and Environment）
- `target`: 设置生成的JavaScript的JavaScript语言版本，并包含兼容的库声明。这里设置为`es2016`，即ECMAScript 2016。
- `lib`: 指定一组捆绑的库声明文件，描述目标运行时环境。
- `jsx`: 指定生成的JSX代码类型。
- `experimentalDecorators`: 启用对旧实验性装饰器的实验性支持。
- `emitDecoratorMetadata`: 在源文件中为装饰声明的声明发出设计类型元数据。
- `jsxFactory`: 指定在目标React JSX发出时使用的JSX工厂函数。
- `jsxFragmentFactory`: 指定在目标React JSX发出时用于片段的JSX片段引用。
- `jsxImportSource`: 指定使用`jsx: react-jsx*`时导入JSX工厂函数的模块说明符。
- `reactNamespace`: 指定在目标`react` JSX发出时调用`createElement`的对象。
- `noLib`: 禁用包含任何库文件，包括默认的`lib.d.ts`。
- `useDefineForClassFields`: 发出符合ECMAScript标准的类字段。
- `moduleDetection`: 控制用于检测模块格式JS文件的方法。

### 模块（Modules）
- `module`: 指定生成的模块代码类型。这里设置为`commonjs`，即CommonJS模块。
- `rootDir`: 指定源文件中的根文件夹。
- `moduleResolution`: 指定TypeScript如何从给定的模块说明符查找文件。
- `baseUrl`: 指定解析非相对模块名称的基本目录。
- `paths`: 指定一组条目，这些条目重新映射导入到其他查找位置。
- `rootDirs`: 允许在解析模块时将多个文件夹视为一个。
- `typeRoots`: 指定多个文件夹，它们的行为类似于`./node_modules/@types`。
- `types`: 指定不引用源文件的类型包名称。
- `allowUmdGlobalAccess`: 允许从模块访问UMD全局变量。
- `moduleSuffixes`: 指定在解析模块时搜索的文件名后缀列表。
- `allowImportingTsExtensions`: 允许导入带有TypeScript文件扩展名的文件。需要设置`--moduleResolution bundler`和`--noEmit`或`--emitDeclarationOnly`。
- `resolvePackageJsonExports`: 在解析包导入时使用`package.json`的`exports`字段。
- `resolvePackageJsonImports`: 在解析导入时使用`package.json`的`imports`字段。
- `customConditions`: 在解析导入时设置除解析器特定默认值之外的条件。
- `noUncheckedSideEffectImports`: 检查副作用导入。
- `resolveJsonModule`: 启用导入`.json`文件。
- `allowArbitraryExtensions`: 启用导入任何扩展名的文件，前提是存在声明文件。
- `noResolve`: 禁止`import`、`require`或`<reference>`从扩展项目文件的数量。

### JavaScript支持（JavaScript Support）
- `allowJs`: 允许JavaScript文件成为程序的一部分。使用`checkJs`选项从这些文件中获取错误。
- `checkJs`: 启用在类型检查的JavaScript文件中的错误报告。
- `maxNodeModuleJsDepth`: 指定用于检查`node_modules`中的JavaScript文件的文件夹最大深度。仅适用于`allowJs`。

### 发射（Emit）
- `declaration`: 从TypeScript和JavaScript文件在项目中生成`.d.ts`文件。
- `declarationMap`: 为`.d.ts`文件创建源映射。
- `emitDeclarationOnly`: 仅输出`.d.ts`文件，不输出JavaScript文件。
- `sourceMap`: 为发出的JavaScript文件创建源映射文件。
- `inlineSourceMap`: 将源映射文件包含在发出的JavaScript中。
- `noEmit`: 禁用从编译中发出文件。
- `outFile`: 指定将所有输出打包成一个JavaScript文件的文件。如果`declaration`为true，还指定一个文件，该文件将所有`.d.ts`输出打包在一起。
- `outDir`: 指定所有发出的文件的输出文件夹。
- `removeComments`: 禁用发出注释。
- `importHelpers`: 允许从`tslib`一次导入帮助函数，而不是每个文件都包含它们。
- `downlevelIteration`: 发出更符合、但冗长且性能较差的JavaScript进行迭代。
- `sourceRoot`: 指定调试器在找到引用源代码时应定位的根路径。
- `mapRoot`: 指定调试器应定位映射文件的位置，而不是生成的位置。
- `inlineSources`: 将源代码包含在发出的源映射中。
- `emitBOM`: 在输出文件的开始处发出UTF-8字节顺序标记（BOM）。
- `newLine`: 设置发出文件的换行符。
- `stripInternal`: 禁用在JSDoc注释中带有`@internal`的声明发出声明。
- `noEmitHelpers`: 禁用在编译输出中生成自定义帮助函数，如`__extends`。
- `noEmitOnError`: 如果报告了任何类型检查错误，则禁用发出文件。
- `preserveConstEnums`: 禁用在生成的代码中擦除`const enum`声明。
- `declarationDir`: 指定生成的声明文件的输出目录。

### 互操作约束（Interop Constraints）
- `isolatedModules`: 确保每个文件可以安全地转译，而无需依赖其他导入。
- `verbatimModuleSyntax`: 不转换或省略任何未标记为类型仅的导入或导出，确保它们以输出文件的格式编写，基于`module`设置。
- `isolatedDeclarations`: 要求导出的注释足够，以便其他工具可以轻松生成声明文件。
- `allowSyntheticDefaultImports`: 允许`import x from y`，当模块没有默认导出时。
- `esModuleInterop`: 发出额外的JavaScript以简化对CommonJS模块的支持。这为类型兼容性启用了`allowSyntheticDefaultImports`。
- `preserveSymlinks`: 禁用解析符号链接到其实际路径。
- `forceConsistentCasingInFileNames`: 确保导入中的大小写正确。

### 类型检查（Type Checking）
- `strict`: 启用所有严格的类型检查选项。
- `noImplicitAny`: 对隐含`any`类型的表达式和声明启用错误报告。
- `strictNullChecks`: 在类型检查时考虑`null`和`undefined`。
- `strictFunctionTypes`: 在赋值函数时，检查参数和返回值是否是子类型兼容的。
- `strictBindCallApply`: 检查`bind`、`call`和`apply`方法的参数是否与原始函数匹配。
- `strictPropertyInitialization`: 检查在构造函数中未设置的类属性。
- `strictBuiltinIteratorReturn`: 内置迭代器实例化时`TReturn`类型为`undefined`而不是`any`。
- `noImplicitThis`: 启用当`this`类型为`any`时的错误报告。
- `useUnknownInCatchVariables`: 默认将`catch`子句变量设置为`unknown`，而不是`any`。
- `alwaysStrict`: 确保始终发出`use strict`。
- `noUnusedLocals`: 当本地变量未读取时启用错误报告。
- `noUnusedParameters`: 当函数参数未读取时引发错误。
- `exactOptionalPropertyTypes`: 将可选属性类型解释为编写的内容，而不是添加`undefined`。
- `noImplicitReturns`: 启用对函数中未显式返回的代码路径的错误报告。
- `noFallthroughCasesInSwitch`: 启用对`switch`语句中未处理的案例的错误报告。
- `noUncheckedIndexedAccess`: 使用索引访问时，将`undefined`添加到类型。
- `noImplicitOverride`: 确保派生类中覆盖的成员被标记为`override`修饰符。
- `noPropertyAccessFromIndexSignature`: 对使用索引类型声明的键强制使用索引访问器。
- `allowUnusedLabels`: 禁用未使用的标签的错误报告。
- `allowUnreachableCode`: 禁用未到达代码的错误报告。

### 完整性（Completeness）
- `skipDefaultLibCheck`: 跳过包含TypeScript的类型检查`.d.ts`文件。
- `skipLibCheck`: 跳过所有`.d.ts`文件的类型检查。

这个配置文件主要用于控制TypeScript编译器的行为，包括语言版本、模块系统、类型检查、输出文件等。通过调整这些选项，可以优化TypeScript项目的编译过程，以满足特定的开发需求。</pre>
</div>
<h1>二、声明文件</h1>
<h2>2.1、为什么需要声明文件</h2>
初始化项目
<pre class="hljs shell"><code>$ mkdir test-declare
$ cd test-declare
$ npm init -y
$ yarn add typescript -D
$ npx tsc --init
</code></pre>
创建 src/sum/index.js 文件，内容如下：这是一个最普通不过的 js 文件，对外暴露 sum () 方法，在 nodejs 中运行。
<pre class="hljs javascript"><code class="language-js">function sum(a, b) {
return a + b
}

module.exports = sum
</code></pre>
创建 src/index.ts 文件，内容如下：（这是一个 ts 文件，在 ts 文件中导入 js 文件）
<pre class="hljs coffeescript"><code class="language-ts">import sum from './sum'

console.log(sum(2, 2))
</code></pre>
这时，如果使用 Vscode 编辑代码，应该可以看到如下的报错：意思就是没找到 sum 文件的声明文件。
<img src="https://oscimg.oschina.net/oscnet/up-89ee5be9d01175f1319ea253dbdf790ae4a.png" alt="" class="zoom-in-cursor">
为什么会报这个错误？
typescript 编译器看到的每个变量、方法都必须明确知道它的类型，在 src/index.ts 文件中导入 src/sum/index.js 文件，js 文件中的方法是没有类型的，造成 typescript 不能识别的错误。
解决方法也很简单，编辑 tsconfig.json 文件：
<pre class="hljs rust"><code class="language-json">"allowJs": true,
"outDir": "./dist",
"rootDir": "./src",
</code></pre>
其中 allowJs 配置告诉 typescript 编辑器将 js 文件中的所有变量和方法都设置 any 类型，这样 typescript 编译器就能识别 js 文件了。
添加配置后报错消失，鼠标移动到 sum () 方法可以看到方法参数确确实实都设置为 any 类型了。
<img src="https://oscimg.oschina.net/oscnet/up-e75b0b4200b512c4e4fea6ef868c60855b5.png" alt="" class="zoom-in-cursor">
此时目录结构应该如下：
<pre class="hljs sql"><code>|-- test-declare
|-- src
 |-- sum
 |-- index.js
 |-- index.ts
|-- package.json
|-- tsconfig.json
</code></pre>
编译代码
打开黑窗口，编译代码，编译完成后根目录下会生成 dist 目录。
<pre class="hljs shell"><code class="language-bash">$ npx tsc -w
</code></pre>
启动程序
另外打开一个黑窗口，运行程序，可以看到打印出计算结果。
<pre class="hljs shell"><code class="language-bash">$ node dist/index.js
$ 4
</code></pre>
虽然 ts 文件中可以导入 js 文件，并正常运行程序，但但但但但但是，js 文件的方法类型全是 any 很恶心。
我们希望为 js 文件里的变量和方法添加真实的类型，这就需要定义声明文件。
<h2>2.2、定义类型声明文件</h2>
创建 src/sum/index.d.ts 文件，内容如下：
<pre class="hljs sql"><code class="language-ts">declare function sum(a: number, b: number): number

export default sum
</code></pre>
此时再查看 src/index.ts 文件，可以看到导入的 sum () 方法的参数已经有类型提示了。👍
<img src="https://oscimg.oschina.net/oscnet/up-a28da8c045c4d1bd6d48df044a794ad6285.png" alt="" class="zoom-in-cursor">
此时目录结构为：
<pre class="hljs sql"><code>|-- test-declare
|-- src
 |-- sum
 |-- index.js
 |-- index.d.ts <=== 类型声明文件
 |-- index.ts
|-- package.json
|-- tsconfig.json
</code></pre>
<h2>2.3、给第三方库写声明文件</h2>
很多第三方库是用 js 写的，通过设置 <code>allowJs: true</code> 配置可以在 typescript 工程使用这些库，但是没法知道库里面变量的类型以及方法参数的类型，很不友好。
我们期待：在 Vscode 开发时，只要敲出方法，编辑器可以自行提示该方法参数的类型是什么，这样我就不会把原本该写成数值类型的参数写成字符串类型了，大大降低代码出错风险。
<img src="https://oscimg.oschina.net/oscnet/up-83586587ac61f54fa169f68f7981bbea282.png" alt="" class="zoom-in-cursor">
如果你是第三方库作者
如果您是第三方库的作者，我们希望您在自己的库里就添加上声明文件。
手动创建 node_modules/subtract 模拟第三方库，切换到 subtract 目录下执行 <code>$ npm init -y</code> 初始化 subtract 工程。
<pre class="hljs sql"><code>|-- test-declare
|-- node_modules <=== 手动创建 subtract 模拟第三方库
 |-- subtract
 |-- src
 |-- index.js
 |-- index.d.ts
 |-- package.json
|-- src
|-- ....
</code></pre>
编辑 node_modules/subtract/src/index.js 文件，内容如下：
<pre class="hljs javascript"><code class="language-js">function subtract(a, b) {
return a - b
}

module.exports = subtract
</code></pre>
编辑 node_modules/subtract/index.d.js 文件，内容如下：
<pre class="hljs sql"><code class="language-ts">declare function subtract(a: number, b: number): number

export default subtract
</code></pre>
修改 package.json 文件，其中 types 指向声明文件路径。
<pre class="hljs python"><code class="language-json">"main": "./src/index.js",
"types": "./index.d.ts",
</code></pre>
<blockquote>
实测发现，外部库找第三方库声明文件默认路径为第三方库 (subtract) 根目录下的 index.d.ts 文件，找不到的话，会去找第三方库 package.json 中 types 字段中设置的路径。
</blockquote>
编辑 src/index.ts 文件，导入 subtract 库并执行方法，鼠标移动到 subtract () 方法上，可以看到也是有参数类型提示的，测试成功。
<img src="https://oscimg.oschina.net/oscnet/up-bc1266a05fe23e8e1a589fb0664dfe14bfc.png" alt="" class="zoom-in-cursor">
如果你是第三方库的使用者
如果您是第三方库的使用者，您是没法直接修改第三方库的源码，只能改自己的代码。
手动创建 node_modules/multiply 模拟第三方库，切换到 multiply 目录下执行 $ npm init -y 初始化 multiply 工程。
<pre class="hljs sql"><code>|-- test-declare
|-- node_modules <=== 手动创建 multiply 模拟第三方库
 |-- multiply
 |-- index.js
 |-- package.json
|-- src
|-- ....
</code></pre>
编辑 test-declare/node_modules/multiply/index.js 文件：
<pre class="hljs javascript"><code class="language-js">function multiply(a, b) {
return a * b
}

module.exports = multiply
</code></pre>
修改 test-declare/src/index.ts 文件，导入 multiply 模块，可以看到报错：没有找到 multiply 模块的声明文件。
<img src="https://oscimg.oschina.net/oscnet/up-4f10db95dc7a29eb6c3f6c6eecafccc83bd.png" alt="">
报错信息也提供了两种解决方案：
<ul>
<li><code>npm install @types/multiply</code> 这种方案前提是有人已经写好了声明文件，我们可以直接安装下就哦了；</li>
<li><code>add a new declaration(.d.ts) file containing "declare module multiply"</code> 如果没有 @types/multiply 包，还可以在根目录下新建 global.d.ts，内容写上 <code>declare module 'multiply'</code>。这样做只能保证代码不报错，但是鼠标移动到 multiply 上面是没有参数类型提示的，这明显不是我们想要的。</li>
</ul>
<img src="https://oscimg.oschina.net/oscnet/up-c687cf05b9b9c74d6452495cba53152827e.png" alt="" class="zoom-in-cursor">
（如果前面创建了 global.d.ts，删除它）
创建 test-declare/types/multiply/index.d.ts 文件写声明文件，types 下目录的名字一定要和第三方库的名字一毛一样，这里为第三方库 multiply 写声明文件，因此创建 types/multiply 目录。
<pre class="hljs sql"><code class="language-ts">declare function multiply(a: number, b: number): number

export default multiply
</code></pre>
编辑 tsconfig.json 文件，告诉 typescirpt 去哪里找我们自己定义的声明文件。
<pre class="hljs python"><code class="language-json">"baseUrl": "./",
"paths": {
"*": [ "types/*" ]
},
</code></pre>
回过头看下 src/index.ts 文件，multiply () 方法的参数类型已经可以显示了。
<img src="https://oscimg.oschina.net/oscnet/up-6bfd8ef690bb180e516a6f9ee31eeea2922.png" alt="" class="zoom-in-cursor">
此时目录结构为：
<pre class="hljs sql"><code>|-- test-declare
|-- ...
|-- src
|-- types
 |-- multiply
 |-- index.d.ts <=== 声明文件
|-- ....
</code></pre>
<h2>2.4、如何写声明文件</h2>
还剩最后一个话题，如何编写声明文件，这需要掌握 Typescript 基本语法。
导出一个方法
上面👆写的所有声明方法都是对外暴露一个方法，暴露变量类似。
源码 index.js
<pre class="hljs javascript"><code class="language-js">function divide (a, b) {
return a / b
}
</code></pre>
为 index.js 编写声明文件：
<pre class="hljs sql"><code class="language-ts">// index.d.ts
declare function divide(a: number, b: number): number
export default divide
</code></pre>
导出一个对象字面量
想要导出一个对象字面量，这个对象字面量内包含了很多方法和变量，如何做？
源码 my-math.js
<pre class="hljs javascript"><code class="language-js">function multiply(a, b) {
return a * b
}

function divide(a, b) {
return a / b
}

const num1 = 4
const num2 = 2

module.exports = {
multiply, divide, num1, num2
}
</code></pre>
使用 namespace 对外导出一个对象字面量，对应的声明文件：
<pre class="hljs sql"><code class="language-ts">// index.d.ts
declare namespace obj {
function multiply(a: number, b: number): number
function divide(a: number, b: number): number
const num1: number
const num2: number
}

export default obj
</code></pre>
使用：
<pre class="hljs lua"><code class="language-ts">// index.ts
import math from 'multiply'
console.log(math.multiply(math.num1, math.num2))</code></pre>
<h1 class="md-end-block md-heading">三、webpack</h1>
请先看完：https://www.cnblogs.com/best/p/10083024.html
中文文档：https://webpack.docschina.org/configuration/mode/
印记：https://docschina.org/
 
<div>
<div>
<h2>3.1、打包项目</h2>
<ul>
<li>
创建一个项目文件夹并初始化项目 <code>npm init -y</code>
</li>
<li>
生成 package.json 配置文件
</li>
<li>
修改文件, 增加 bulid 命令 <code>"build": "webpack"</code>,
<div class="image-package">
<div class="image-container">
<div class="image-view" data-width="595" data-height="237"><img src="//upload-images.jianshu.io/upload_images/27010224-780dc274959e2fd3.png?imageMogr2/auto-orient/strip|imageView2/2/w/595/format/webp" data-original-src="//upload-images.jianshu.io/upload_images/27010224-780dc274959e2fd3.png" data-original-width="595" data-original-height="237" data-original-format="image/png" data-original-filesize="14080" data-image-index="0"></div>
</div>
</div>
</li>
<li>
webpack 部分
<ul>
<li>
安装 webpack 需要的一些依赖
<div class="cnblogs_code">
<pre>npm i -D webpack webpack-cli typescript ts-loader</pre>
</div>
</li>
<li>
创建 webpack 的配置文件 webpack.config.js
</li>
<li>
<div class="_bg-header_17ta2_46">webpack.config.js</div>
<div class="_content_17ta2_4">
<div class="item-contenter_2r52f">
<div class="content-box_712xg">
<div>
<div class="dqa-markdown_5emil ">
<div class="markdown_1jK8o">
Webpack 是一个开源的 JavaScript 模块打包器，它可以将模块打包成静态资源，用于浏览器运行。webpack.config.js 是 Webpack 的配置文件，其中包含了 Webpack 打包的配置参数。
以下是一个基本的 webpack.config.js 文件示例：
<div class="cnblogs_code">
<pre>const path = require('path');

module.exports = {
entry: './src/index.js',
output: {
filename: 'bundle.js',
path: path.resolve(__dirname, 'dist'),
},
module: {
rules: [
 {
 test: /\.css$/,
 use: ['style-loader', 'css-loader'],
 },
 {
 test: /\.(png|svg|jpg|gif)$/,
 use: ['file-loader'],
 },
],
},
};</pre>
</div>
上述配置文件中包含了以下配置项：
<ul>
<li>
<div class="dqa-li-inner">
<code class="dqa-code-span">entry</code>: 指定入口文件路径，此处为 './src/index.js'。
</div>
</li>
<li>
<div class="dqa-li-inner">
<code class="dqa-code-span">output</code>: 指定打包输出文件路径和文件名，此处为 './dist/bundle.js'。
</div>
</li>
<li>
<div class="dqa-li-inner">
<code class="dqa-code-span">module</code>: 配置加载器，例如在上面的示例中，使用了 style-loader 和 css-loader 处理 CSS 文件，使用 file-loader 处理图片文件。
</div>
</li>
</ul>
在上述示例中，Webpack 将从 './src/index.js' 开始打包，最终生成一个名为 'bundle.js' 的文件，并将其放置在 './dist/' 目录下。加载器用于处理不同类型的文件，例如 CSS、图片等。
</div>
</div>
</div>
</div>
</div>
</div>
</li>
</ul>
</li>
</ul>
<div class="_2Uzcx_">
<div class="cnblogs_code">
<pre> // 引入一个包
const path = require('path')

// webpack 中的所有的配置信息都应该写在 module.exports 中
module.exports = {

// 指定入口文件
entry: "./src/index.ts",

// 指定打包文件所在目录
 output: {
 // 指定打包后的目录
 path: path.resolve(__dirname, 'dist'),

 // 打包后文件的文件名
 filename: "bundle.js"
},

// 指定 webpack 打包时要使用模块
 module: {

 // 指定要加载的规则
 rules: [{
 // test 指定规则生效的文件
 test: /\.ts$/,
 // 要使用的 loader
 use: 'ts-loader',
 // 要排除的文件
 exclude: /node_modules/
 }]

}
}</pre>
</div>
</div>
<ul>
<li>filename可以设置成：filename: '..js'</li>
<li>TypeScript 部分
<ul>
<li>创建 typescript 配置文件
<div class="cnblogs_code">
<pre>tsc --init</pre>
</div>
</li>
</ul>
</li>
<li>生成文件 tsconfig.json</li>
</ul>
<div class="_2Uzcx_">
<div class="cnblogs_code">
<pre>{
"compilerOptions": {
"target": "es5",
"module": "commonjs",
"strict": true,
}
}</pre>
</div>
</div>
<ul>
<li>执行 npm run build 进行打包, 生成打包文件, 这时候就能看到打包后的效果啦, 下面再让我们看看怎么把项目运行起来吧!</li>
</ul>
</div>
<img src="https://img2022.cnblogs.com/blog/63651/202209/63651-20220927162343278-424408097.png" alt="" loading="lazy">
<div>
<h2>3.2、创建HTML</h2>
　　在src目录下创建一个模板文件index.html
<div class="cnblogs_code">
<pre><!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title><%=htmlWebpackPlugin.options.title %></title>
</head>
<body></body>
</html></pre>
</div>
<%=%>这是ejs的语法，获取标题。
<ul>
<li>安装 webpack 插件, 使的打包后会自动创建 html 文件, 并自动引入相关的 js 文件
<div class="cnblogs_code">
<pre>npm i -D html-webpack-plugin</pre>
</div>
</li>
</ul>
配置 webpack.config.js 文件
<div class="image-package">
<div class="image-container">
<div class="image-view" data-width="1016" data-height="348"><img src="https://img2022.cnblogs.com/blog/63651/202209/63651-20220928110010382-867798722.png" alt="" width="894" height="323" loading="lazy"></div>
</div>
<div class="image-caption"> 上面是添加依赖</div>
</div>
<div class="image-package">
<div class="image-container">
<div class="image-view" data-width="981" data-height="413"><img src="https://img2022.cnblogs.com/blog/63651/202209/63651-20220928110053504-809318231.png" alt="" width="508" height="281" loading="lazy"></div>
</div>
<div class="image-caption">执行npm run build</div>
<div class="image-caption"><img src="https://img2022.cnblogs.com/blog/63651/202209/63651-20220927163455261-612131651.png" alt="" loading="lazy">
 查看运行结果
<img src="https://img2022.cnblogs.com/blog/63651/202209/63651-20220927163524477-95043835.png" alt="" loading="lazy">
完整的配置webapck.config.js
<div class="cnblogs_code">
<pre>const path=require('path');
const HTMLWebpackPlugin=require('html-webpack-plugin');

module.exports={
//指定入口文件
entry: './src/main.ts',
output: {
 path:path.resolve(__dirname,'dist'),
 filename:'bundle.js'
},
module:{
 rules:[{
 test: /\.ts$/,
 use:"ts-loader",
 exclude: /node_modules/
 }]
},
plugins:[
 new HTMLWebpackPlugin({
 title:"Hello Webpack!",
 template:'./src/index.html',
 filename:'index.html'})
],
mode: 'production',

}</pre>
</div>
<h2>3.3、使用开发服务器插件运行项目</h2>
</div>
</div>
 
<ul>
<li>安装 webpack 开发服务器插件 ( 可以根据项目的改变自动刷新 )
<div class="cnblogs_code">
<pre>npm i -D webpack-dev-server</pre>
</div>
<ul>
<li>安装时要注意版本兼容问题, webpack 5 版本不兼容比较高版本的 webpack-dev-server, 所以这里安装的是 <code>npm i -D webpack-dev-server@3.11.2</code></li>
<li>配置 package.json 文件 <code>"serve": "webpack serve --open chrome.exe"</code>,
<div class="image-package">
<div class="image-container">
<div class="image-view" data-width="691" data-height="218"><img src="https://img2022.cnblogs.com/blog/63651/202209/63651-20220928110703554-1684874976.png" alt="" width="616" height="129" loading="lazy"></div>
</div>
</div>
</li>
</ul>
</li>
<li>执行 npm start  serve 启动项目</li>
<li><img src="https://img2022.cnblogs.com/blog/63651/202209/63651-20220928110615234-1293065967.png" alt="" width="915" height="461" loading="lazy">
 直接在浏览器中打开了index.html页面
</li>
</ul>
 
<h2>3.4、清理dist目录下的旧文件</h2>
 
<ul>
<li>安装 webpack 插件, 在打包之前清除 dist 目录下的旧文件, 再生成新文件, 避免缓存
<div class="cnblogs_code">
<pre>npm i -D clean-webpack-plugin</pre>
</div>
</li>
<li>插件源码与使用方法：https://github.com/johnagan/clean-webpack-plugin#options-and-defaults-optional
<ul>
<li>引入插件并配置
<div class="image-package">
<div class="image-container">
<div class="image-view" data-width="1117" data-height="275"><img src="//upload-images.jianshu.io/upload_images/27010224-f1dbe4b974201b1c.png?imageMogr2/auto-orient/strip|imageView2/2/w/1117/format/webp" data-original-src="//upload-images.jianshu.io/upload_images/27010224-f1dbe4b974201b1c.png" data-original-width="1117" data-original-height="275" data-original-format="image/png" data-original-filesize="32076" data-image-index="4"></div>
</div>
</div>
<div class="image-package">
<div class="image-container">
<div class="image-view" data-width="1045" data-height="323"><img src="//upload-images.jianshu.io/upload_images/27010224-a565ca3da8cae790.png?imageMogr2/auto-orient/strip|imageView2/2/w/1045/format/webp" data-original-src="//upload-images.jianshu.io/upload_images/27010224-a565ca3da8cae790.png" data-original-width="1045" data-original-height="323" data-original-format="image/png" data-original-filesize="44274" data-image-index="5"></div>
</div>
</div>
</li>
</ul>
</li>
</ul>
<h2>3.5、给 webpack 设置可引用模块</h2>
通过对resolve库的使用来解析模块路径，帮助 webpack 找到 bundle 中以require/import引入的模块代码
<ul>
<li style="list-style-type: none">
<ul>
<li>
用来设置引用模块 (这样配置自后, 里面索设置的文件类型可以作为模块引用)
<div class="image-package">
<div class="image-container">
<div class="image-view" data-width="891" data-height="168"><img src="//upload-images.jianshu.io/upload_images/27010224-94349eb962d971c7.png?imageMogr2/auto-orient/strip|imageView2/2/w/891/format/webp" data-original-src="//upload-images.jianshu.io/upload_images/27010224-94349eb962d971c7.png" data-original-width="891" data-original-height="168" data-original-format="image/png" data-original-filesize="24402" data-image-index="6"></div>
<div class="image-view" data-width="891" data-height="168"> </div>
</div>
</div>
</li>
</ul>
</li>
</ul>
</div>
</div>
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
通常情况下，实际开发中我们都需要使用构建工具对代码进行打包，TS同样也可以结合构建工具一起使用，下边以webpack为例介绍一下如何结合构建工具使用TS。
</li>
<li class="md-list-item">
步骤：
<ol class="ol-list" start="">
<li class="md-list-item">
初始化项目
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
进入项目根目录，执行命令 <code>npm init -y</code>
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
主要作用：创建package.json文件
</li>
</ul>
</li>
</ul>
</li>
<li class="md-list-item">
下载构建工具
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
<code>npm i -D webpack webpack-cli webpack-dev-server typescript ts-loader clean-webpack-plugin</code>
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
共安装了7个包
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
webpack
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
构建工具webpack
</li>
</ul>
</li>
<li class="md-list-item">
webpack-cli
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
webpack的命令行工具
</li>
</ul>
</li>
<li class="md-list-item">
webpack-dev-server
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
webpack的开发服务器
</li>
</ul>
</li>
<li class="md-list-item">
typescript
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
ts编译器
</li>
</ul>
</li>
<li class="md-list-item">
ts-loader
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
ts加载器，用于在webpack中编译ts文件
</li>
</ul>
</li>
<li class="md-list-item">
html-webpack-plugin
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
webpack中html插件，用来自动创建html文件
</li>
</ul>
</li>
<li class="md-list-item">
clean-webpack-plugin
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
webpack中的清除插件，每次构建都会先清除目录
</li>
</ul>
</li>
</ul>
</li>
</ul>
</li>
</ul>
</li>
<li class="md-list-item">
根目录下创建webpack的配置文件webpack.config.js
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
<pre class="md-fences md-end-block ty-contain-cm modeLoaded">const path = require("path"); const HtmlWebpackPlugin = require("html-webpack-plugin"); const { CleanWebpackPlugin } = require("clean-webpack-plugin"); module.exports = {    optimization:{        minimize: false // 关闭代码压缩，可选  },    entry: "./src/index.ts",        devtool: "inline-source-map",        devServer: {        contentBase: './dist'  },    output: {        path: path.resolve(__dirname, "dist"),        filename: "bundle.js",        environment: {            arrowFunction: false // 关闭webpack的箭头函数，可选      }  },    resolve: {        extensions: [".ts", ".js"]  },        module: {        rules: [          {                test: /\.ts$/,                use: {                   loader: "ts-loader"                  },                exclude: /node_modules/          }      ]  },    plugins: [        new CleanWebpackPlugin(),        new HtmlWebpackPlugin({            title:'TS测试'      }),  ] }</pre>
</li>
</ul>
</li>
<li class="md-list-item">
根目录下创建tsconfig.json，配置可以根据自己需要
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
<pre class="md-fences md-end-block ty-contain-cm modeLoaded">{    "compilerOptions": {        "target": "ES2015",        "module": "ES2015",        "strict": true  } }</pre>
</li>
</ul>
</li>
<li class="md-list-item">
修改package.json添加如下配置
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
<pre class="md-fences md-end-block ty-contain-cm modeLoaded">{  ...略...  "scripts": {    "test": "echo \"Error: no test specified\" && exit 1",    "build": "webpack",    "start": "webpack serve --open chrome.exe" },  ...略... }</pre>
</li>
</ul>
</li>
<li class="md-list-item">
在src下创建ts文件，并在并命令行执行<code>npm run build</code>对代码进行编译，或者执行<code>npm start</code>来启动开发服务器
 
</li>
</ol></li>
</ul>
<h1 class="md-end-block md-heading">四、Babel</h1>
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
经过一系列的配置，使得TS和webpack已经结合到了一起，除了webpack，开发中还经常需要结合babel来对代码进行转换以使其可以兼容到更多的浏览器，在上述步骤的基础上，通过以下步骤再将babel引入到项目中。
<ol class="ol-list" start="">
<li class="md-list-item">
安装依赖包：
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
<code>npm i -D @babel/core @babel/preset-env babel-loader core-js</code>
</li>
<li class="md-list-item">
共安装了4个包，分别是：
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
@babel/core
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
babel的核心工具
</li>
</ul>
</li>
<li class="md-list-item">
@babel/preset-env
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
babel的预定义环境
</li>
</ul>
</li>
<li class="md-list-item">
@babel-loader
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
babel在webpack中的加载器
</li>
</ul>
</li>
<li class="md-list-item">
core-js
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
core-js用来使老版本的浏览器支持新版ES语法
</li>
</ul>
</li>
</ul>
</li>
</ul>
</li>
<li class="md-list-item">
修改webpack.config.js配置文件
<ul class="ul-list" data-mark="-">
<li class="md-list-item">
<pre class="md-fences md-end-block ty-contain-cm modeLoaded">...略... module: {    rules: [      {            test: /\.ts$/,            use: [              {                    loader: "babel-loader",                    options:{                        presets: [                          [                                "@babel/preset-env",                              {                                    "targets":{                                        "chrome": "58",                                        "ie": "11"                                  },                                    "corejs":"3",                                    "useBuiltIns": "usage"                              }                          ]                      ]                  }              },              {                    loader: "ts-loader",              }          ],            exclude: /node_modules/      }  ] } ...略...</pre>
</li>
<li class="md-list-item md-focus-container">
如此一来，使用ts编译后的文件将会再次被babel处理，使得代码可以在大部分浏览器中直接使用，可以在配置选项的targets中指定要兼容的浏览器版本。
</li>
</ul>
</li>
</ol></li>
</ul>
<h1>五、视频</h1>
 【TypeScript】 https://www.bilibili.com/video/BV1rT411T7JN?share_source=copy_web&vd_source=475a31f3c5d6353a782007cd4c638a8a
<h1>六、作业</h1>
6.1、Typescript大作业，要求每位同学使用TypeScript完成一个小游戏，可以参考MyGame（魔幻战士）:
<img src="https://img2022.cnblogs.com/blog/63651/202209/63651-20220928085252557-648592865.png" alt="" width="732" height="537" loading="lazy">
1 创建英雄类 Hero,怪兽类Monster,以及Message接口
分别给两个类构建生命值防御力攻击力状态名称等属性以及攻击方法 Attack()。然后Message接口定义头像切换对话框打印保存游戏等方法
2 游戏初始画面
3关卡场景初始化点击新游戏后将进入游戏关卡（背景图片level1, 并用Monster类实例化三个怪兽和Hero实例化一个英雄）如果点击继续游戏就从本地存储获取上一次的游戏数据
4 战斗场景点击怪兽英雄对当前点击怪兽发动攻击(调用Attack()) 以及Message的方法达到如下效果
5 每只怪兽将会在英雄返回后间隔两秒对英雄发动一次攻击
6 当怪兽的血量为零时怪兽判定为死亡图像切换为灰色当全部怪兽死亡后弹出战斗胜利弹窗
 7 当英雄血量为0时弹出战斗失败弹窗
8 点击退出弹出是否保存点击”是”就将当前实例的属性保存到本地存储中如果点击保存按钮直接保存到本地存储中回到游戏首页后点击继续游戏从本地存储获取上一次保存的游戏数据
素材下载：https://gitee.com/zhangguo5/typescript_game.git
  
来源：https://www.cnblogs.com/best/p/16472546.html

頁: [1]

琼殿技术论坛's Archiver

TypeScript学习笔记（三）—— 编译选项、声明文件、WebPack打包、Babel转换