使用@babel/preset-typescript取代awesome-typescript-loader和ts-loader

前言

之前写过一篇旧react项目安装并使用TypeScript的文章:在React旧项目中安装并使用TypeScript的实践。

博客里使用awesome-typescript-loader对Typescript代码进行检测和转换。

而这几天又修改了一下自己的脚手架,使用@babel/preset-typescript来处理Typescript。

 

回顾awesome-typescript-loader方案

谈@babel/preset-typescript的优越性之前,还是先说下awesome-typescript-loader方案是如何对TypeScript进行处理的。

首先我们需要知道TypeScript是一个将TypeScript转换为指定版本js代码的编译器,而Babel同样是一个将新版本js新语法转换为低版本JS代码的编译器。

所以我们之前的方案每次修改了一点代码,都会将TS代码传递给TypeScript转换为JS,然后再将这份JS代码传递给Babel转换为低版本JS代码。

因此我们需要配置两个编译器,并且每次做了一点更改,都会经过两次编译。

 

@babel/preset-typescript方案

介绍这个方案之前,我需要列出我参考的一篇译文:[译] TypeScript 和 Babel:一场美丽的婚姻。

这里提到这是 TypeScript 和 Babel 团队长达一年的官方合作成果,所以至少我们不用担心这是个野生方案会烂尾。

核心提炼一下:@babel/preset-typescript和@babel/preset-react类似,是将特殊的语法转换为JS。

但是有点区别的是,@babel/preset-typescript是直接移除TypeScript,转为JS,这使得它的编译速度飞快。

并且只需要管理Babel一个编译器就行了,因为我将脚手架中的typescript库卸载后,依然可以完美运行。

而且重要的是你写的TypeScript不会再进行类型检测,使得你改动代码后中断运行的页面。

 

所以,检测呢?

我写TypeScript就是用来搞类型检测的啊,你安装了TypeScript,写了TS代码然后再用@babel/preset-typescript移除不是多此一举吗?

不,并不是多此一举。

还记得前面那篇译文吗?

它的方案是使用ESLint,用@typescript-eslint配置ESLint来达到检测的目的。

而我们的方案呢?

我们是高贵的VSCode玩家,咱们自带TS检测,所以这一步咱们可以略过。

 

一些缺陷

上方译文中提到了此方案的以下四个缺陷:

Namespace语法不推荐,改用标准的 ES6 module(import/export)。不支持x 语法转换类型,改用x as newtype。const 枚举历史遗留风格的 import/export 语法。比如:import foo = require(...) 和 export = foo。

第1条和第4条不用,而且已经过时了。
第2条缺陷改一下语法就好了,这个语法会直接提示语法报错,很好改,问题不大。
第3条缺陷已经没有了,亲测可用。

广州设计公司https://www.houdianzi.com 我的007办公资源网站https://www.wode007.com

替换步骤

要使用@babel/preset-typescript,务必确保你是Babel7+。

如果不是Babel7+用户,可以考虑运行下面的两条命令升级:

npm install babel-upgrade -g

babel-upgrade --write

然后我们安装:

npm i --save @babel/preset-typescript

然后将之前在webpack中配置解析tsx的部分去掉,改为:

module: {
  rules: [
    //...
    {
      test: /\.tsx?$/,
      exclude: /node_modules/,
      loader: 'babel-loader',
      options: {
        presets: [
          '@babel/preset-env',
          '@babel/preset-react',
          '@babel/preset-typescript'
        ]
      }
    }
    //...
  ]
}
 

Ant Design的按需加载

必须要把这个东西单独拎出来说,太坑了。

之前的方案咱们使用的是ts-import-plugin来处理的。

所以下意识我觉得这个地方会很麻烦,网上搜各种方案。

然而必然是没有答案的,要么就是ts-import-plugin,要么就是和create-react-app结合在一起的那种。

实际上咱们只需要升级一下babel-plugin-import到最新就可以了。

我之前就是因为babel-plugin-import版本太低,导致只对js文件有效,对ts文件无效。

然后配置一下babel-plugin-import即可:

module: {
  rules: [
    //...
    {
      test: /\.tsx?$/,
      exclude: /node_modules/,
      loader: 'babel-loader',
      options: {
        presets: [
          '@babel/preset-env',
          '@babel/preset-react',
          '@babel/preset-typescript'
        ],
        plugins: [
          ['import', { libraryName: 'antd', style: 'css' }], // `style: true` 会加载 less 文件
        ],
      }
    }
    //...
  ]
}
上一篇:@babel/preset-env


下一篇:Search Insert Position