109 lines
2.7 KiB
Markdown
109 lines
2.7 KiB
Markdown
# 创建 vue3.x vite 项目
|
||
|
||
## 安装 vite
|
||
|
||
```bash
|
||
# 全局安装 vite
|
||
npm install create-vite-app -g
|
||
|
||
# 创建项目，xxx 为项目名称
|
||
create-vite-app xxx
|
||
|
||
# 进入目录
|
||
cd xxx
|
||
|
||
# 安装依赖
|
||
npm install
|
||
|
||
# 运行
|
||
npm run dev
|
||
```
|
||
|
||
## 安装 typescript
|
||
#### 1、安装
|
||
|
||
```bash
|
||
# 安装
|
||
cnpm install typescript --save-dev
|
||
|
||
# 初始化 tsconfig.json，注意初始化时与安装 typescript 同级（项目根目录）
|
||
npx tsc --init
|
||
```
|
||
|
||
npm 安装依赖 `dependencies` 和 `devDependencies` 的区别：
|
||
- `dependencies`：是需要发布到生产环境的
|
||
- `devDependencies`：里面的插件只用于开发环境，不用于生产环境
|
||
|
||
npm 安装方式：
|
||
- `dependencies`：npm install 依赖名称 --save
|
||
- `devDependencies`：npm install 依赖名称 --save-dev
|
||
|
||
其它说明：
|
||
- `dependencies`：插件不管你引不引入都会打包到文件中去
|
||
- `devDependencies`：若文件中 import 引入 devDependencies 中插件，依然会把当前引入的插件打包到文件中，不引入则不打包
|
||
|
||
#### 2、改成 `.ts` 后缀
|
||
将 `main.js` 修改为 `main.ts`，同时将 `index.html` 里面的引用也修改为 `main.ts`，然后在 `script` 里添加 `lang="ts"`
|
||
|
||
index.html
|
||
```html
|
||
<!DOCTYPE html>
|
||
<html lang="en">
|
||
<head>
|
||
<meta charset="UTF-8" />
|
||
<link rel="icon" href="/favicon.ico" />
|
||
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
||
<title>Vite App</title>
|
||
</head>
|
||
<body>
|
||
<div id="app"></div>
|
||
<script type="module" src="/src/main.ts"></script>
|
||
</body>
|
||
</html>
|
||
```
|
||
|
||
app.vue
|
||
```html
|
||
<template>
|
||
<img alt="Vue logo" src="./assets/logo.png" />
|
||
<HelloWorld msg="Hello Vue 3.0 + Vite" />
|
||
</template>
|
||
|
||
<script lang="ts">
|
||
import HelloWorld from "./components/HelloWorld.vue";
|
||
export default {
|
||
name: "App",
|
||
components: {
|
||
HelloWorld,
|
||
},
|
||
};
|
||
</script>
|
||
|
||
```
|
||
|
||
#### 3、出现问题：找不到模块 `./App.vue` 或其相应的类型声明
|
||
打开 main.ts 会发现 `import App from App.vue` 会报错: 找不到模块 `./App.vue` 或其相应的类型声明，这是因为现在 ts 还没有识别 vue 文件，需要进行下面的配置：
|
||
|
||
在项目根目录添加 `shim.d.ts` 文件：
|
||
|
||
```js
|
||
declare module "*.vue" {
|
||
import { Component } from "vue"
|
||
const component: Component
|
||
export default component
|
||
}
|
||
```
|
||
|
||
#### 4、出现问题：安装了 `Vetur` 的话，出现 `[vue/no-multiple-template-root]The template root requires exactly one element.eslint-plugin-vue` 的警告
|
||
|
||
处理方法：关闭了 `Vetur`，Vetur认为这是 Vue 2项目，因为它位于VS Code工作区中。
|
||
|
||
::: warning 提示
|
||
参考顶部 `vsCode` 链接中，打开 `首选项 - 设置 - settings.json`
|
||
:::
|
||
|
||
```json
|
||
"vetur.validation.template": false,
|
||
"vetur.validation.script": false,
|
||
"vetur.validation.style": false,
|
||
``` |