基于 Vite + Vue3 从0搭建项目

403 阅读1分钟

✅ 步骤总览(基于 Vite + Vue3)

阶段内容
1️⃣ 安装工具安装 Node.js 与 Vite 脚手架
2️⃣ 初始化项目使用 npm create vite@latest
3️⃣ 安装依赖安装 Vue、UI 框架、路由、状态管理器等
4️⃣ 目录结构调整创建 views/, router/, store/ 等文件夹
5️⃣ 启动开发本地运行 + 自动热更新
6️⃣ 构建发布打包部署到生产环境

🛠️ 详细步骤

✅ 第 1 步:安装 Node.js 和 Vite(只需一次)

  • 安装 Node.js:nodejs.org/
  • 初始化 Vite 项目:
npm create vite@latest

按照提示选择:

 Project name: » my-vue-app
 Select a framework: » Vue
 Select a variant: » JavaScript / TypeScript

然后进入项目:

cd my-vue-app
npm install

✅ 第 2 步:启动开发服务器

npm run dev

浏览器访问 http://localhost:5173,你将看到 Vue 欢迎页面。


✅ 第 3 步:安装 Vue Router / Pinia(可选)

npm install vue-router pinia

✨ 安装 UI 框架(任选其一)

  • Element Plus(PC)
npm install element-plus
  • Vant(移动端)
npm install vant

✅ 第 4 步:基础目录结构建议

src/
├── assets/         # 静态资源
├── components/     # 公共组件
├── views/          # 页面组件
├── router/         # vue-router 配置
├── store/          # pinia 模块
├── utils/          # 工具函数
├── App.vue
└── main.js / main.ts

✅ 第 5 步:创建 Router(示例)

// 配置router
// src/router/index.js
import { createRouter, createWebHistory } from 'vue-router';
import Home from '@/views/Home.vue';

const routes = [
  { path: '/', component: Home },
  { path: '/about', component: () => import('@/views/About.vue') }
];

const router = createRouter({
  history: createWebHistory(),
  routes,
});

export default router;
// 注册router
// src/main.js
import { createApp } from 'vue';
import App from './App.vue';
import router from './router';

createApp(App).use(router).mount('#app');
// 使用 router
<template>
  <router-view />
</template>

✅ 第 6 步:打包构建

npm run build

生成的 dist/ 目录即为可部署文件,可上传到 nginx、GitHub Pages、Vercel、Netlify 等。


🎁 可选增强配置

目的工具 / 库
状态管理Pinia
接口请求封装Axios
项目规范ESLint + Prettier
Mock 接口Mock Service Worker(msw)
动画过渡Animate.css 或 Vue Transitions
单元测试Vitest / Jest