vue+element项目创建步骤
一、创建vue项目步骤
要创建一个Vue + Element UI的项目，你可以按照以下步骤进行操作：
1.确保你已经安装了Node.js和npm（Node.js的包管理器）。你可以在命令行中运行以下命令来检查它们是否已经安装：
node -v
npm -v
2.使用Vue CLI来创建一个新的Vue项目。在命令行中运行以下命令：
npm install -g @vue/cli
vue create my-project
这将安装Vue CLI并创建一个名为my-project的新项目。在创建项目时，你可以选择手动选择特性或使用默认配置。
3. 进入到项目目录中：
cd my-project
4.安装Element PLUS。在命令行中运行以下命令：
npm install element-plus
5.在项目中使用Element PLUS。在你的Vue应用的入口文件（通常是src/main.js）中，添加以下代码：
import { createApp } from 'vue'
import ElementPlus from 'element-plus'
import 'element-plus/dist/index.css'
const app = createApp(App)
app.use(ElementPlus)
app.mount('#app')
这将引入Element PLUS库，并将其作为Vue应用的插件使用。
6. 运行项目。在命令行中运行以下命令来启动开发服务器：
npm run serve
这将启动开发服务器，并在浏览器中打开你的Vue应用。
现在，你已经成功创建了一个Vue + Element PLUS的项目。你可以根据需要在项目中使用Element UI的组件和样式。
也可以手动打开此网址。
二、项目结构说明
在Vue 中，通常使用Vue CLI来创建和管理项目，它会自动生成一套默认的目录结构。下面是一个典型的Vue 3项目的目录结构说明：
my-project/
|- public/
| |- index.html
|
|- src/
| |- assets/
| |- components/
| |- views/
| |- App.vue
| |- main.js
|
|- package.json
|- vue.config.js
|- README.md
-
public/：这个目录包含了公共的静态资源，如index.html文件和其他不需要经过构建处理的文件。
-
src/：这个目录是项目的主要源代码目录。
-
assets/：这个目录用于存放项目的静态资源，如图片、样式文件等。
-
components/：这个目录用于存放项目的可复用组件。
-
views/：这个目录用于存放项目的页面组件。
-
App.vue：这是项目的根组件，包含了整个应用的布局和路由视图的渲染。
-
main.js：这是项目的入口文件，用于初始化Vue应用并挂载根组件。
-
package.json：这个文件是项目的配置文件，包含了项目的依赖和脚本等信息。
-
vue.config.js：这个文件是Vue CLI的配置文件，用于自定义构建配置和开发服务器等选项。
-
README.md：这个文件是项目的说明文档，通常包含了项目的介绍、安装和使用方法等信息。
这只是一个简单的目录结构示例，实际的项目可能会根据需求和团队的偏好进行调整和扩展。
三、安装路由
在Vue 3中，你可以使用Vue Router来进行路由管理。要在路由配置中添加新页面的路由，你可以按照以下步骤进行操作：
1.在你的Vue项目中，确保已经安装了Vue Router。如果没有安装，可以使用以下命令进行安装：
npm install vue-router
判断是否安装成功可以看一下package.json是否显示vue-router的版本号
2.在项目的src文件中，创建一个新的文件夹router，里面放置index.js，用于配置路由。src/router/index.js
3.在此文件中，导入Vue和Vue Router，并创建一个新的路由实例。示例代码如下：
import { createRouter, createWebHistory } from 'vue-router'
import Indexfrom '../views/Index/IndexPage.vue'
const routes = [
{
path: '/',
name: 'Index',
component: Index
}
]
const router = createRouter({
history: createWebHistory(),
routes
})
export default router
在上面的示例中，我们将路由实例作为Vue应用的插件使用。
现在，你已经成功在路由配置中添加了新页面的路由。你可以根据需要继续添加其他页面的路由配置。
4.在Vue 3应用程序的入口文件（通常是main.js）中使用了上述路由配置。示例代码如下：
import {
createApp
} from 'vue'
import App from './App.vue'
import ElementPlus from 'element-plus'
import 'element-plus/dist/index.css'
import router from './router'
const app = createApp(App)
app.use(ElementPlus)
app.use(router)
app.mount('#app')
我们将路由配置通过 use 方法注入到Vue应用程序中。
报错处理：
error Component name “XXX” should always be multi-word vue/multi-word-component-
这些错误信息是由Vue的ESLint插件生成的，用于检查和提醒开发者在Vue组件中的一些最佳实践和规范。如果出现这种错误，要么选择规范自己的代码，要么选择关闭验证。其他的处理情况可以进行百度。
可以在package.json文件里面添加rule规则：
"rules": {
"vue/multi-word-component-names": "off"
}
四、创建首页并显示内容
indexPage.vue文件内容：
<template>
<div>
你好
div>
template>
<script>
export default {
name: 'Index',
// 组件逻辑代码
}
script>
<style>
/* 样式规则 */
style>
router/index.js文件：
import {
createRouter,
createWebHistory
} from 'vue-router'
import Index from '../views/Index/IndexPage.vue'
const routes = [{
path: '/',
name: 'Index',
component: Index
}]
const router = createRouter({
history: createWebHistory(),
routes
})
export default router
App.vue文件：
<template>
<div id="app">
<router-view>router-view>
div>
template>
<script>
export default {
name: 'App',
components: {
}
}
script>
<style>
#app {
font-family: Avenir, Helvetica, Arial, sans-serif;
-webkit-font-smoothing: antialiased;
-moz-osx-font-smoothing: grayscale;
}
style>
（一）如果运行没有效果，（以下和上面项目目录文件等不关联，这里只是举例）可能有以下几个原因：
1.检查路由配置：确保你的路由配置正确，并且将根路径 / 与 index 组件关联起来。在路由配置文件中，确保你有类似以下的代码：
import { createRouter, createWebHistory } from 'vue-router';
import Index from '@/views/Index.vue';
const routes = [
{
path: '/',
name: 'Index',
component: Index
},
// 其他路由配置...
];
const router = createRouter({
history: createWebHistory(),
routes
});
export default router;
2.检查入口文件：在入口文件（通常是 main.js）中，确保你正确地使用了路由配置。示例代码如下：
import { createApp } from 'vue';
import router from './router';
import App from './App.vue';
createApp(App).use(router).mount('#app');
确保你使用了正确的路由配置文件，并将其通过 use 方法注入到Vue应用程序中。
3. 检查组件名称：确保你的 index 组件的名称与路由配置中的组件名称一致。在 Index.vue 文件中，确保你有类似以下的代码：
<template>
template>
<script>
export default {
name: 'Index',
// 组件逻辑代码
}
script>
<style>
/* 样式规则 */
style>
确保 name 属性的值与路由配置中的组件名称一致。
4.路由出口：在你的根组件（通常是App.vue）中，确保你有一个路由出口（）来渲染对应的页面。
<template>
<div id="app">
<router-view>router-view>
div>
template>
五、跳转页面
路由链接：如果你在其他页面或组件中需要导航到views/Index/IndexPage页面，确保你使用了正确的路由链接。
【此处是根据你的命名写法来，代码不可生硬照搬】
<router-link to="/index">Go to Index Pagerouter-link>
写法还有其他形式
<router-link :to="{ path: 'home' }">Homerouter-link>
<router-link :to="{ name: 'user', params: { userId: 123 }}">Userrouter-link>
<router-link :to="{ path: 'about', query: { userName: 'qqq' }}">aboutrouter-link>
六、使用组件
1.创建公共组件，例如导航栏。在components文件夹里面创建一个NavBar.vue文件。
<template>
<div class="navBar">
<ul class="navList">
<li v-for="item in navItems" :key="item.path" :class="{ active: item.path === $route.path }"
@click="goTo(item)">{{ item.label }}li>
ul>
<el-menu :default-active="activeIndex" class="el-menu-demo" mode="horizontal">
<el-menu-item :index="item.id" v-for="item in navItems" :key="item.path"
@click="goTo(item)">{{ item.label }}el-menu-item>
el-menu>
div>
template>
<script>
export default {
name: 'NavBar',
data() {
return {
navItems: [{
id: '1',
path: '/',
label: '首页'
},
{
id: '2',
path: '/About',
label: '关于'
},
{
id: '3',
path: '/IndexDetail',
label: '详情'
}
],
activeIndex: '1'
}
},
mounted() {
this.activeIndex = localStorage.getItem('activeIndex');
},
methods: {
goTo(item) {
this.$router.replace(item.path);
localStorage.setItem('activeIndex', item.id);
},
}
}
script>
<style scoped>
.navList {
display: flex;
list-style: none;
}
.navList li {
width: 100px;
line-height: 50px;
height: 50px;
border: 1px solid red;
text-align: center;
}
.active {
color: #3a82f3;
position: relative;
}
.active::after {
content: "";
position: absolute;
left: 0;
bottom: 0;
width: 100%;
height: 4px;
background-color: #3a82f3;
}
style>
2.在其他页面使用该组件。其他页面也是同样的操作，引入、注册、使用。
<template>
<div>
<NavBar>NavBar>
这是首页
div>
template>
<script>
import NavBar from '../../components/NavBar.vue'
export default {
name: 'Index',
components:{
NavBar
}
}
script>
<style>
style>
七、状态管理store
状态管理：
https://cn.vuejs.org/guide/scaling-up/state-management.html
在Vue 3中，store文件夹通常用于存放Vuex相关的代码和文件。Vuex是Vue的官方状态管理库，用于管理应用程序的状态。
在store文件夹中，一般会包含以下文件或目录：
1. index.js：这是Vuex的主要入口文件。在这个文件中，你可以创建Vuex的store实例，并导出它供应用程序使用。
2. state.js：这个文件用于定义应用程序的状态。你可以在这里定义和初始化应用程序的各种状态变量。
3. mutations.js：这个文件包含了Vuex的mutations。Mutations是用于修改状态的函数，它们接收state作为参数，并对其进行修改。
4. actions.js：这个文件包含了Vuex的actions。Actions是用于处理异步操作和提交mutations的函数。它们可以包含异步逻辑，并在需要时触发mutations。
5. getters.js：这个文件包含了Vuex的getters。Getters是用于从状态中派生出新的数据的函数。它们可以对状态进行计算或过滤，并返回派生的数据。
除了上述文件，你还可以根据需要在store文件夹中创建其他文件或目录，以组织和管理你的Vuex代码。
需要注意的是，这只是一种常见的组织方式，你可以根据你的项目需求和个人偏好进行调整和扩展。
ref:
https://cn.vuejs.org/api/reactivity-core.html#ref
ref是Vue 3中的一个函数，它是Vue Composition API的一部分。ref函数用于创建一个响应式的数据引用。
在Vue 3中，响应式是通过ref函数来实现的。当你使用ref函数创建一个变量时，它会返回一个包装了原始值的响应式引用。这意味着当引用的值发生变化时，Vue会自动追踪这个变化，并在需要时更新相关的视图。
以下是一个使用ref函数的示例：
import { ref } from 'vue';
const count = ref(0);
console.log(count.value); // 输出: 0
count.value++; // 修改值
console.log(count.value); // 输出: 1
在上面的示例中，我们使用ref函数创建了一个名为count的变量，并将其初始值设置为0。通过访问count.value，我们可以获取到该变量的值。当我们修改count.value时，Vue会自动更新相关的视图。
需要注意的是，由于ref函数返回的是一个包装了原始值的引用，所以在访问或修改变量的值时，需要使用.value来进行操作。
reactive()
reactive()是Vue 3中的一个函数，它是Vue Composition API的一部分。reactive()函数用于创建一个响应式的对象。
在Vue 3中，响应式是通过reactive()函数来实现的。当你使用reactive()函数创建一个对象时，它会返回一个包装了原始对象的响应式代理。这意味着当代理对象的属性发生变化时，Vue会自动追踪这些变化，并在需要时更新相关的视图。
import { reactive } from 'vue';
const state = reactive({
count: 0,
message: 'Hello'
});
console.log(state.count); // 输出: 0
console.log(state.message); // 输出: 'Hello'
state.count++; // 修改值
console.log(state.count); // 输出: 1
在上面的示例中，我们使用reactive()函数创建了一个名为state的响应式对象。state对象包含了count和message两个属性。通过访问state.count和state.message，我们可以获取到这些属性的值。当我们修改state.count时，Vue会自动更新相关的视图。
需要注意的是，由于reactive()函数返回的是一个包装了原始对象的代理对象，所以在访问或修改对象的属性时，不需要使用额外的.value来进行操作。
八、vue3.0代理配置以及接口封装
【1】vue3.0代理配置以及接口封装：
https://blog.csdn.net/x_Yanger/article/details/106079274
【2】vue中 关于proxy的理解：
https://blog.csdn.net/ks8380/article/details/110678815?spm=1001.2014.3001.5506
devServer 中的 proxy 选项用于配置代理，将以 /api 开头的请求转发到 http://e.dxy.net。
ws 设置为 true 表示开启 WebSocket 支持。
secure 设置为 false 表示不验证 SSL 证书。
changeOrigin 设置为 true 表示修改请求头中的 Host 字段。
【3】要在 Vue 3 中安装和使用 Axios，可以按照以下步骤进行操作：
1.打开终端，并进入你的 Vue 3 项目的根目录。
2.运行以下命令来安装 Axios 依赖：
npm install axios
或者如果你使用的是 Yarn 包管理器，可以运行以下命令：
yarn add axios
3.安装完成后，你可以在你的 Vue 3 项目中的任何组件中使用 Axios。在需要使用 Axios 的组件中，可以通过以下方式引入 Axios：
import axios from 'axios';
4.现在，你可以使用 Axios 来发送 HTTP 请求。例如，你可以在组件的方法中使用 Axios 发送 GET 请求：
axios.get('/api/data')
.then(response => {
// 处理响应数据
})
.catch(error => {
// 处理错误
});
上面第一条链接是有关于接口封装的，前提就是得先安装axios,安装完之后可以去浏览使用。
九、运行自动弹出浏览器
在 Vue 3 中，你可以通过配置 devServer 的 open 属性来实现在运行应用程序后自动弹出浏览器。
在你的 vue.config.js 文件中，可以添加以下配置：
module.exports = {
// 其他配置项...
devServer: {
open: true
}
};
设置 open 为 true，这将告诉开发服务器在启动时自动打开浏览器。
十、vue3单页面
用到什么就需要引入什么。
<template>
<div>
<NavBar>NavBar>
<el-carousel :interval="5000" arrow="always">
<el-carousel-item v-for="(item, index) in bannerList" :key="index">
<img :src="app.$utils.image(item.image)" class="bannerImg" />
el-carousel-item>
el-carousel>
div>
template>
<script setup>
import app from '@/app/index'
import { onMounted } from 'vue';
import {
ref
} from "vue";
import NavBar from '../../components/NavBar.vue'
onMounted(() => {
getInfo()
})
const bannerList = ref([])
function getInfo() {
app.$api.addArticle({
type: 'index'
}).then(res => {
console.log(res);
bannerList.value = res.data
});
}
script>
<style scoped>
.bannerImg {
width: 100%;
height: 100%;
object-fit: contain;
}
style>
加上setup之后写法不再是之前的写法，不需要写export进行暴露