⚠️ Vue CLI 处于维护模式!

对于新项目,现在建议使用 create-vue 来搭建基于 Vite 的项目。另请参阅 Vue 3 工具指南 以获取最新建议。

@vue/cli-plugin-typescript

vue-cli 的 typescript 插件

使用 TypeScript + ts-loader + fork-ts-checker-webpack-plugin 实现更快的非线程类型检查。

配置

TypeScript 可以通过 tsconfig.json 进行配置。

3.0.0-rc.6 开始,typescript 现在是此包的 peer 依赖项,因此您可以通过更新项目的 package.json 来使用特定版本的 TypeScript。

此插件可以与 @vue/cli-plugin-babel 一起使用。当与 Babel 一起使用时,此插件将输出 ES2015 并将其余部分委托给 Babel,以便根据浏览器目标进行自动 polyfill。

缓存

cache-loader 默认启用,缓存存储在 <projectRoot>/node_modules/.cache/ts-loader 中。

并行化

thread-loader 在机器拥有超过 1 个 CPU 内核时默认启用。这可以通过在 vue.config.js 中设置 parallel: false 来关闭。

当将 Typescript 与不可序列化加载器选项(例如正则表达式、日期和函数)结合使用时,应将 parallel 设置为 false。这些选项不会正确传递给 ts-loader,这可能会导致意外错误。

在已创建的项目中安装

vue add typescript

注入的 webpack-chain 规则

  • config.rule('ts')
  • config.rule('ts').use('ts-loader')
  • config.rule('ts').use('babel-loader')(当与 @vue/cli-plugin-babel 一起使用时)
  • config.rule('ts').use('cache-loader')
  • config.plugin('fork-ts-checker')