PixelAI-admin/vue-admin-wonderful-next-docs/docs/config/README.md

109 lines
2.7 KiB
Markdown
Raw Normal View History

# 创建 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,
```