Vue-cli3项目引入Typescript的实现方法

前言假设已经有一个通过vue-cli3脚手架构建的vue项目命令行安装Typescriptnpminstall--save-devtypescr

前言

假设已经有一个通过 vue-cli3 脚手架构建的 vue 项目

命令行安装 Typescript

npm install --save-dev typescript
npm install --save-dev @vue/cli-plugin-typescript

编写 Typescript 配置

根目录下新建 tsconfig.json，下面为一份配置实例(点击查看所有配置项)。值得注意的是，默认情况下，ts 只负责静态检查，即使遇到了错误，也仅仅在编译时报错，并不会中断编译，最终还是会生成一份 js 文件。如果想要在报错时终止 js 文件的生成，可以在 tsconfig.json 中配置 noEmitOnError 为 true。

{
 "compilerOptions": {
 "target": "esnext",
 "module": "esnext",
 "strict": true,
 "importHelpers": true,
 "moduleResolution": "node",
 "experimentalDecorators": true,
 "esModuleInterop": true,
 "allowSyntheticDefaultImports": true,
 "sourceMap": true,
 "baseUrl": ".",
 "allowJs": false,
 "noEmit": true,
 "types": [
 "webpack-env"
 ],
 "paths": {
 "@/*": [
 "src/*"
 ]
 },
 "lib": [
 "esnext",
 "dom",
 "dom.iterable",
 "scripthost"
 ]
 },
 "exclude": [
 "node_modules"
 ]
}

新增 shims-vue.d.ts

根目录下新建 shims-vue.d.ts，让 ts 识别 *.vue 文件，文件内容如下

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

修改入口文件后缀

src/main.js => src/main.ts

改造 .vue 文件

.vue 中使用 ts 实例

// 加上 lang=ts 让webpack识别此段代码为 typescript
<script lang="ts">
 import Vue from 'vue'
 export default Vue.extend({
 // ...
 })
</script>

一些好用的插件

vue-class-component：强化 Vue 组件，使用 TypeScript装饰器 增强 Vue 组件，使得组件更加扁平化。点击查看更多

import Vue from 'vue'
import Component from 'vue-class-component'

// 表明此组件接受propMessage参数
@Component({
 props: {
 propMessage: String
 }
})
export default class App extends Vue {
 // 等价于 data() { return { msg: 'hello' } }
 msg = 'hello';
 
 // 等价于是 computed: { computedMsg() {} }
 get computedMsg() {
 return 'computed ' + this.msg
 }
 
 // 等价于 methods: { great() {} }
 great() {
 console.log(this.computedMsg())
 }
}

vue-property-decorator：在 vue-class-component 上增强更多的结合 Vue 特性的装饰。点击查看更多

import { Vue, Component, Prop, Watch, Emit } from 'vue-property-decorator'

@Component
export default class App extends Vue {
 @Prop(Number) readonly propA: Number | undefined
 @Prop({ type: String, default: ''}) readonly propB: String
 
 // 等价于 watch: { propA(val, oldval) { ... } }
 @Watch('propA')
 onPropAChanged(val: String, oldVal: String) {
 // ...
 }
 
 // 等价于 resetCount() { ... this.$emit('reset') }
 @Emit('reset')
 resetCount() {
 this.count = 0
 }
 
 // 等价于 returnValue() { this.$emit('return-value', 10, e) }
 @Emit()
 returnValue(e) {
 return 10
 }
 
 // 等价于 promise() { ... promise.then(value => this.$emit('promise', value)) }
 @Emit()
 promise() {
 return new Promise(resolve => {
 resolve(20)
 })
 }
}

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持脚本之家。