【亲测免费】 Vite-Vue3-Admin 项目教程

2026-01-18 10:23:45作者：史锋燃Gardner

1. 项目的目录结构及介绍

vite-vue3-admin/
├── public/
│   └── index.html
├── src/
│   ├── assets/
│   ├── components/
│   ├── layouts/
│   ├── router/
│   ├── store/
│   ├── views/
│   ├── App.vue
│   └── main.js
├── .env
├── .gitignore
├── index.html
├── package.json
├── README.md
├── vite.config.js
└── yarn.lock

目录结构介绍

public/: 存放公共资源，如 index.html。
src/: 源代码目录，包含所有前端代码。
- assets/: 存放静态资源，如图片、字体等。
- components/: 存放可复用的 Vue 组件。
- layouts/: 存放页面布局组件。
- router/: 存放 Vue Router 配置文件。
- store/: 存放 Vuex 状态管理文件。
- views/: 存放页面视图组件。
- App.vue: 根组件。
- main.js: 入口文件。
.env: 环境变量配置文件。
.gitignore: Git 忽略文件配置。
package.json: 项目依赖和脚本配置。
README.md: 项目说明文档。
vite.config.js: Vite 配置文件。
yarn.lock: Yarn 依赖锁定文件。

2. 项目的启动文件介绍

main.js

main.js 是项目的入口文件，负责初始化 Vue 应用并挂载到 DOM 上。

import { createApp } from 'vue'
import App from './App.vue'
import router from './router'
import store from './store'

const app = createApp(App)
app.use(router)
app.use(store)
app.mount('#app')

index.html

index.html 是项目的入口 HTML 文件，Vite 会将其作为模板，并在开发服务器启动时注入必要的脚本和样式。

<!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.js"></script>
  </body>
</html>

3. 项目的配置文件介绍

vite.config.js

vite.config.js 是 Vite 的配置文件，用于配置开发服务器、构建选项等。

import { defineConfig } from 'vite'
import vue from '@vitejs/plugin-vue'

export default defineConfig({
  plugins: [vue()],
  server: {
    port: 3000,
  },
})

.env

.env 文件用于定义环境变量，Vite 会自动加载这些变量并在项目中使用。

VITE_APP_TITLE=Vite Vue3 Admin
VITE_APP_API_BASE_URL=http://localhost:3000

package.json

package.json 文件包含了项目的依赖、脚本和其他元数据。

{
  "name": "vite-vue3-admin",
  "version": "1.0.0",
  "scripts": {
    "dev": "vite",
    "build": "vite build",
    "serve": "vite preview"
  },
  "dependencies": {
    "vue": "^3.0.0",
    "vue-router": "^4.0.0",
    "vuex": "^4.0.0"
  },
  "devDependencies": {
    "vite": "^2.0.0",
    "@vitejs/plugin