vue3项目中引入ts

本文介绍: 基于 vue3项目的基础上引入 ts

提示：文章是基于 vue3的项目基础上引入 ts

文章 目录

1.基于脚手架的情况下创建 vue3项目
2.启动未引入ts的vue3项目
3.在页面中（HomeView.vue）引入ts
4.配置vue3+ts项目
5.其他配置
6.在HomeView.vue 使用Ts语法

1.基于脚手架的情况下创建 vue3项目

vue create vue3-ts

选择自定义预设，ts 设置未选中状态
在这里插入图片描述
 选择 yarn与npm 启动项目（根据个人，在这里我选择 y arn）

2.启动未引入 t s的vue3项目

在这里插入图片描述

3.在页面中（Ho m eView.v ue）引入 t s

问题一：
在这里插入图片描述
问题二：

问题一

在script 标签中引入ts后，会产生JSX语法错误，这时我们需要引入ts（全局引用与局部引用）
第一步：
全局或者局部引用Ts并通过 tsc -v 查看版本号 ts安装成功，这里我直接在项目中 yarn add typescript
npm install –g typescript
yarn ad d –g typescript（需要添加环境变量后 tsc-v生效）
在这里插入图片描述

注意：使用yarn全局引入后需要配置环境变量后 tsc-v才生效
第二步：
命令生成 ts配置文件 tsconfig.json

tsc --init  //生成 tsconfig.json

用以下内容填充该文件，如有重复，删除此文件内的重复项

{
    "compilerOptions": {
        "outDir": "./built/",
        "sourceMap": true,
        "strict": true,
        "noImplicitReturns": true,
        "module": "es2015",
        "moduleResolution": "node",
        "target": "es5"
    },
    "include": [
        "./src/**/*"
    ]
}

在 tsconfig.json 文件中设置 “jsx”：“pre serve”，设置后发现还是报错，（这里设置无效，如果设置有效下一步可以略过，继续百度）
第三步：在jsconfig.json 文件下添加与 jsx（jsx 属性允许我们在项目中使用 .tsx 文件）
在这里插入图片描述

解决问题二（找不到模块“XXX.vue”或其相应的类型声明）

在根目录中创建 shims.d.ts文件

declare module '*.vue' {
    import { ComponentOptions } from 'vue'
    const componentOptions: ComponentOptions
    export default componentOptions
}
declare module '*'

我们也可以修改 tsconfig.json 中替换 declare mod ule ‘*’ 如下所示

"noImplicitAny": false,
"allowJs": true,

尝试打开项目会发现如下报错
在这里插入图片描述
解决方案：
安装我们的依赖 确保安装了 TypeSc ript、Web pack、Vue 和必要的加载程序。

安装@vue/cli-plugin-typescript

@vue/cli–plugin–typescript 内部预置了ts-loader的配置，无需单独配置（这一步是不是覆盖掉）

yarn add  @vue/cli-plugin-typescript --save-dev

安装完毕后尝试打开项目
在这里插入图片描述
我们将 main.js 改为 main.ts {构建成功}

我们尝试注释掉 shims.d.ts 中的 declare mod ule ‘*’ 或者替代他的 tsconfig 文件中的
“noIm pli citAny”: false, “allowJs”: true,

再次编译项目会发现引入的router与store 没有相应的内置类型文件，当然m a in.js不会出现此问题（个人理解）
在这里插入图片描述
修改回来 tsconfig.json shims.d.ts我们进行下一步

4.配置vue3+ts项目

我们可以看到在模块文件中产生分号报错，但是他并不会影响项目启动，我们对typescript–eslint进行配置
在这里插入图片描述

yarn add  @typescript-eslint/eslint-plugin @typescript-eslint/parser --save-dev

yarn add  @vue/eslint-config-typescript --save-dev

修改.eslint rc.js

module.exports = {
    extends: [
        'plugin:vue/vue3-essential',
        'eslint:recommended',
        '@vue/typescript/recommended'
    ],
    plugins: [
        'vue',
        '@typescript-eslint'
    ],
    rules: {
        '@typescript-eslint/no-unused-vars': 'error',
        // 允许非空断言
        '@typescript-eslint/no-non-null-assertion': 'off',
        // 允许自定义模块和命名空间
        '@typescript-eslint/no-namespace': 'off',
        // 允许对this设置alias
        '@typescript-eslint/no-this-alias': 'off',
        // 允许使用any类型
        '@typescript-eslint/no-explicit-any': ['off'],
        ......
    }
}

错误解决
在这里插入图片描述
项目中会出现如下错误

解决：在.eslintrc.js文件中添加以下代码

5.其他配置

###vue.config.js配置增加extension，引入 ts/tsx 文件时不必加后缀

module.exports = {
    chainWebpack: config =&gt; {
          config.resolve.extensions
            .add('ts')
            .add('tsx');
    }
}

在vscode中command+,打开settiings.json可配置保存时自动eslint格式化
在这里插入图片描述

6.在HomeView.vue 使用Ts语法

<template&gt;
  <div class="home"&gt;
    <img alt="Vue logo" src="../assets/logo.png" /&gt;
    <HelloWorld msg="Welcome to Your Vue.js App" /&gt;
  </div&gt;
</template&gt;

<script setup lang="ts"&gt;
import { ref } from "vue";
import HelloWorld from "@/components/HelloWorld.vue";
interface Todo {
  id: number;
  title: string;
  isCompleted: boolean;
}
const aa = ref<Todo[]>([])
console.log(aa);
const bb:boolean = false
console.log(bb);
</script>