5分钟为vue-cli2构建项目添加typescript

去年咱们将基于 vue-cli2 构建的项目中的 webpack3 升级到 webpack4。今年咱们继续升(zhe)级(teng)，添加 typescript。

目前市场上大部分脚手架在生成项目时都会提示是否要安装 typescript. 好比 vue-cli3+。但仍是有不少老项目或者是经过 vue-cli2 构建的项目一直在被维护中。若是你想对这些老项目从新改造、以旧换新，为其添加 typescript 支持的话，Give me five minutes Plz。

只须要如下 6 小步。

1. 安装相关依赖

$ npm install typescript ts-loader vue-property-decorator -D
复制代码

typescript 必须安装，你要问能不能不安装它，哼哼~你究竟干啥来的！

ts-loader 告诉 webpack 我是 ts.

vue-property-decorator 让 vue 支持修饰器，这里也可使用 vue-class-component. 至于用法这里不讲，想了解能够点击开发教程进行阅读.

2. 修改 webpack 配置

在 build 目录下找到 webpack.base.config.js 文件. 新增一个 rule 配置.

module: {
  rules: [
    ...
    {
      test: /\.tsx?$/i,
      use: [{
        loader: 'ts-loader',
        options: {
          appendTsSuffixTo: [/\.vue$/]
        }
      }],
      exclude: /node_modules/
    },
    
    ...
复制代码

3. 建立 vue 声明文件

在 src 目录下建立一个 shims-vue.d.ts 文件，这里叫啥无所谓，可是必需要以 .d.ts 为后缀.

declare module '*.vue' {
  import Vue from 'vue'
  export default Vue
}
复制代码

其做用是让TS编译器识别 vue 文件.

4. 建立 tsconfig.json

在项目根目录下建立 tsconfig.json 文件. 这个文件可使用 tsc 命令建立.

$ tsc --init
复制代码

若是提示没有 tsc，你须要在全局安装 typescript

$ npm install typescript -g
复制代码

文件配置以下：

{
  "compilerOptions": {
    "strict": true,
    "module": "es2015",
    "moduleResolution": "node",
    "target": "es5",
    "allowSyntheticDefaultImports": true,
    "declaration": false,
    "noImplicitAny": true,
    "strictNullChecks": true,
    "emitDecoratorMetadata": true,
    "experimentalDecorators": true,
    "allowJs": true,
    "lib": [
      "es2017",
      "es2016",
      "dom"
    ]
  },
  "include": ["src/**/*.*"],
  "exclude": ["node_modules", "build", "dist"]
}
复制代码

这里不对配置一一进行介绍，想要了解能够点击编译选项进行阅读.

5. 用 ts 替换 js 文件

有 4 处文件须要修改

• src/App.vue

<script lang="ts">
import { Vue, Component } from 'vue-property-decorator'

@Component
export default class App extends Vue {
}
</script>
复制代码

• src/components/HelloWorld.vue

<script lang="ts">
import { Vue, Component } from 'vue-property-decorator'

@Component
export default class HelloWorld extends Vue {
  msg: string = 'Welcome to Your Vue.js App'
}
</script>
复制代码

• src/router/index.ts

import Vue from 'vue'
import Router, { RouteConfig } from 'vue-router'

import HelloWorld  from '@/components/HelloWorld.vue'
Vue.use(Router)
const routes: RouteConfig[] = [
  {
    path: '/',
    component:HelloWorld
  }
]
export default new Router({
  routes
})
复制代码

• src/main.ts

import Vue from 'vue'
import App from './App.vue'
import router from './router/index'

Vue.config.productionTip = false

/* eslint-disable no-new */
new Vue({
  el: '#app',
  router,
  components: { App },
  template: '<App/>'
})
复制代码

6. 修改 entry

回到 webpack.base.config.js 配置文件，讲入口的 main.js 修改成 main.ts 便可.

module.exports = {
  entry: {
    app: './src/main.ts'
  }
  ...
}
复制代码

到这里对 vue-cli2 添加 typescript 升级改造大(qing)功(er)告(yi)成(ju).

相关连接

最后相关示例和总结双手奉上.

demo示例

升级过程

typescript开发教程