一、前言
上一篇讲到库的打包，本篇将介绍 TypeScript 的打包配置。
二、TS
TypeScript 是 JavaScript 类型的超集，它能够被转换为普通的 JavaScript。为了在 webpack cli 中使用 ts，就需要安装特定的 loader 来“翻译” ts 语法。
2.1 依赖安装
npm install --save-dev typescript ts-loader
2.2 tsconfig.json
在根目录下新建 tsconfig.js，它是 ts 的配置文件。
{ "compilerOptions": { "outDir": "./dist/", // 这个可以不写，因为在webpack配置中已经写了 "noImplicitAny": true, // 不允许隐式any类型 "module": "es6", // 模块引入方式 "target": "es5", // 打包后编译成什么形式 "jsx": "react", // 引入react "allowJs": true, // 在ts文件中允许引入js文件 "moduleResolution": "node" // 引入模块的方式 } }
接下来打开 webpack.config.js 。
2.3 webpack.config.js
const path = require('path'); module.exports = { entry: './src/index.ts', // 注意这里原来是 './src/index.js'，需要改成 ts 结尾！ module: { rules: [ { test: /\.tsx?$/, use: 'ts-loader', exclude: /node_modules/, }, ], }, resolve: { extensions: ['.tsx', '.ts', '.js'], }, output: { filename: 'bundle.js', path: path.resolve(__dirname, 'dist'), }, };
这样一来，将会引导 webpack 进入 "./src/index.ts" ，然后利用 ts-loader 加载所有的 .ts 以及 .tsx 结尾的文件，最后在当前目录下生成一个 bundle.js 文件。
注意：
- 入口文件需要改后缀，我们现在用 ts 了，不用 js ；
- 配置规则中的 tsx 指的是： ts + jsx ；
- resolve 可以配置模块的解析方式，一般常用来设置 alias 别名以及 extensions 后缀名解析顺序。
三、js 改写为 ts 的示例
3.1 js 示例
greeter.js
import _ from 'lodash'; class Greeter { constructor (message) { this.greeting = message; } greet () { return _.join(['Hello ', this.greeting], ''); } } export default Greeter;
index.ts
import Greeter from "./ts/greeter"; let greeter = new Greeter("JavaScript!"); let button = document.createElement("button"); button.textContent = "Say Hello"; button.onclick = function () { alert(greeter.greet()); }; document.body.appendChild(button);
3.2 ts 示例
现在将 3.1 中的 js 示例改用 ts 编写：
greeter.ts
import * as _ from "lodash"; // 注意这里！ class Greeter { greeting: string; constructor(message: string) { this.greeting = message; } greet() { return _.join(["Hello, ", this.greeting], ""); } } export default Greeter;
注意：
- 由于 lodash.js 没有默认导出，所以需要改为上面的写法。
- 如果想要按照原来的
import _ from 'lodash';，则需要在 tsconfig.js 中添加参数allowSyntheticDefaultImports，将它设置为 true 即可。
{ "compilerOptions": { // ... "allowSyntheticDefaultImports": true } }
之后，和 3.1 一样，将它引入到 index.ts 文件中。
结果发现：我们的代码居然是运行不起来的。lodash 下面有一条红线：
四、声明文件
在 TS 中，有一类文件是以 .d.ts 结尾的，这一类文件属于类型声明文件。TS 比 JS 多了类型检查，而这个声明文件就是类型检查的关键，所以为了让 TS 能够识别第三方库的 JS，就需要安装特定的声明文件。按照错误提示，我们需要按照以下依赖：@types/lodash
npm i --save-dev @types/lodash
在我们安装完成以后，重新运行项目，即可正常运行。
小结
- 要想在项目中添加 TS 相关的配置，则先要安装 typescript 和 ts-loader；
- 依赖安装完成后，需要添加 tsconfig.js 和相关配置参数，以及在 webpack.config.js 中添加 ts-loader 的规则；
- 在使用第三方库的时候，注意需要安装对应的类型声明文件，避免引用错误。
