Vue / 系统课时
确定技术栈与项目边界
确定技术栈与项目边界
技术栈的价值不在于工具数量,而在于每个工具职责清楚、协作路径稳定。本课将为 Vue 3 管理后台划分视图、类型、构建、路由、状态和组件六类职责,并用最小项目验证这些依赖能够共同运行。
学习目标
- 说明 Vue 3、TypeScript、Vite、Vue Router、Pinia 与 Element Plus 的职责
- 理解一次页面访问经过的主要协作链路
- 明确哪些能力应由业务代码实现,哪些应交给基础设施
技术栈职责划分
| 技术 | 主要职责 | 不应承担的职责 |
|---|---|---|
| Vue 3 | 组件、模板、响应式更新 | 全局权限规则与服务端业务校验 |
| TypeScript | 类型约束、接口建模、重构保护 | 运行时数据真实性保证 |
| Vite | 开发服务器、构建与模块处理 | 页面状态与业务流程 |
| Vue Router | URL、页面映射、导航守卫 | 长期业务数据存储 |
| Pinia | 跨组件状态与业务动作 | 所有局部表单状态 |
| Element Plus | 通用界面组件与交互规范 | 业务规则与接口协议 |
这套边界可以避免“万能工具”。例如,路由守卫可以阻止未登录用户进入页面,但后端接口仍必须再次校验身份;TypeScript 能检查调用方式,却不能保证接口返回的数据一定可信。
六项技术如何协作

浏览器访问 URL 后,Vue Router 选择页面组件;页面从 Pinia 读取用户与权限状态,再使用 Element Plus 组合界面。TypeScript 在开发阶段约束路由、状态和接口类型,Vite 负责启动开发环境并在交付时生成静态资源。
创建最小可运行项目
下面的命令创建 Vue 3 与 TypeScript 项目,并加入路由、状态管理和组件库。示例要求已安装当前受支持的 Node.js LTS 与 npm。
npm create vite@latest vue3-admin -- --template vue-ts
cd vue3-admin
npm install
npm install vue-router pinia element-plus
npm run dev预期输出
VITE v<VERSION> ready in <TIME> ms
Local: http://localhost:<PORT>/实际版本、启动时间和端口可能不同。浏览器打开终端给出的本地地址,出现 Vite 默认页面即表示 Vue 3、TypeScript 与 Vite 已正常工作;其余依赖已经安装,但还需要在入口文件中注册后才会生效。
在入口文件注册基础设施
这是项目入口的完整示例,用来建立应用、路由、Pinia 和 Element Plus 的装配顺序。它依赖项目中已存在 src/App.vue,并要求创建 src/router/index.ts 导出路由实例。
import { createApp } from 'vue'
import { createPinia } from 'pinia'
import ElementPlus from 'element-plus'
import 'element-plus/dist/index.css'
import App from './App.vue'
import router from './router'
const app = createApp(App)
// 先注册全局基础设施,再挂载根组件。
app.use(createPinia())
app.use(router)
app.use(ElementPlus)
app.mount('#app')生效行为:Pinia、Router 与 Element Plus 都可在组件中使用。验证时重新运行 npm run dev;若终端无模块解析错误、页面能够打开,入口装配即成功。
业务边界怎么定
路由配置只描述页面地址、组件映射和必要的访问元信息;用户资料、令牌和权限集合放入 Pinia;短期输入状态保留在页面组件中。Element Plus 提供交互组件,但字段含义、提交条件和错误处理仍由业务代码定义。
接口请求建议单独放入服务层,页面不直接拼接地址,也不在组件中散落鉴权头。这样未来替换接口、统一错误处理或增加请求追踪时,不必逐页修改。