Vue2.X强上TypeScript

准备

就是使用 vue-cli2.0 创建一个项目，一个正儿八经的 vue-cli2.0 的 vue 项目

开始

1.安装依赖

安装 vue 的官方插件 npm i vue-class-component vue-property-decorator -S
typescript 必须安装 npm i typescript -D
ts-loader 必须安装 npm i ts-loader -D 请注意：ts-loader 请与你的 webpack 版本对应，我的 webpack 版本为 3.6.0，因此我应该安装的 ts-loader 版本为 3.x.x，因此我在ts-loader的Github上找到了我最新的 3.x.x 的版本为 3.5.0，所以我的安装命令为npm i [email protected] -D

2.配置 webpack.base.conf.js

首先找到./build/webpack.base.conf.js

• 找到 entry.app 将 main.js 改成 main.ts；并且把项目文件中的 main.js 也改成 main.ts , 里面内容保持不变

entry: {
        app: './src/main.ts'
    }

• 找到resolve.extensions，里面加上.ts 后缀 （是为了之后引入.ts 的时候不写后缀）

resolve: {
        extensions: ['.js', '.vue', '.json', '.ts'], //加入.ts
        alias: {
            vue$: 'vue/dist/vue.esm.js',
            '@': resolve('src')
        }
    }

• 找到module.rules 添加webpack对.ts的解析

module: {
        rules: [
            // 从这里复制下面的代码就可以了
            {
                test: /\.tsx?$/,
                loader: 'ts-loader',
                exclude: /node_modules/,
                options: {
                    appendTsSuffixTo: [/\.vue$/]
                }
            },
            // 复制以上的
            {
                test: /\.vue$/,
                loader: 'vue-loader',
                options: vueLoaderConfig
            }
        ]
    }

3.添加 tsconfig.json

在根路径下创建tsconfig.json文件，添加一下配置

{
    "include": ["src/**/*"],
    "exclude": ["node_modules"],
    "compilerOptions": {
        "allowSyntheticDefaultImports": true,
        "experimentalDecorators": true,
        "allowJs": true,
        "module": "esnext",
        "target": "es5",
        "moduleResolution": "node",
        "isolatedModules": true,
        "lib": ["dom", "es5", "es6", "es7", "es2015.promise"],
        "sourceMap": true,
        "pretty": true
    }
}

4.让 ts 识别 .vue

由于 TypeScript 默认并不支持 *.vue后缀的文件，所以在 vue 项目中引入的时候需要创建一个 vue-shim.d.ts 文件，放在项目对应使用目录下，所以新建 src/vue-shim.d.ts，写入以下代码

declare module '*.vue' {
    import Vue from 'vue'
    export default Vue
}

5..js 文件重命名为.ts 文件

将src下的所有**.js文件重命名**.ts，包括src/router/index.js等逐一从.js重命名为.ts

注意：重命名后对vue文件的import，需添加.vue后缀

因为Typescript默认只识别*.ts文件，不识别*.vue文件

之前：

import App from './App'
import HelloWorld from '@/components/HelloWorld'

需改为：

import App from './App.vue'
import HelloWorld from '@/components/HelloWorld.vue'

6.改造 .vue 文件

要点：

• 改造后：

  之后请将所有的.vue按照vue-class-component改造

  7.运行 npm run dev

  至此运行项目，即可正常运行，vue对typescript的初步引入，基本完成。

  8.让vue识别全局方法/变量

  因为在项目中，会存在自己写的一些方法是放在 vue.prototype上的。
  如：Vue.prototype.$api = myApi，然后想在每个.vue里面这样使用this.$api，然而使用ts改造之后，在.vue里面使用this.$api会报错

  Property '$api' does not exist on type 'Text'

  请在main.ts里面加上这段： 请放在 new Vue上面

  Vue.config.productionTip = false
  // 全局方法 this. 的调用方式
  declare module 'vue/types/vue' {
     interface Vue {
         $tool: any
         $api: any
     }
  }
  /* eslint-disable no-new */
  new Vue({
     el: '#app',
     store,
     router,
     components: { App },
     template: ''
  })
  

  然后就能愉快的使用 this.$api 和 this.$tool

  配置完成的项目在此template_ts

  参考链接

  Vue2.5+ Typescript 引入全面指南
  vue + typescript 项目起手式
  Vue全家桶+TypeScript使用总结