Vue 3 现代开发指南：系列导航

更新日期：2026-08-31
技术基线：Vue 3.5、Vite 8、Vue Router 5、Pinia 4、TypeScript 7

原来的 Vue 3 长文同时讲工程搭建、响应式、路由、状态管理和组件通信，不适合一次阅读，也不方便单独更新。本系列将这些内容拆成 9 篇可以独立发布的文章：每篇只解决一组相关问题，并统一使用当前 Vue 官方推荐的 Composition API、<script setup> 和 TypeScript 写法。

系列目录

篇目	内容	发布链接
01	Vue 3 现代工程搭建：create-vue、Vite 8 与 TypeScript	开始阅读
02	Composition API 与 `<script setup>`	开始阅读
03	响应式基础：`ref`、`reactive`、`toRef` 与 `toRefs`	开始阅读
04	派生状态与副作用：`computed`、`watch`、生命周期和组合式函数	开始阅读
05	组件契约：Props、Emits、`defineModel` 与插槽	开始阅读
06	跨层通信：模板引用、`provide/inject` 与事件总线	开始阅读
07	Vue Router 5：手写路由与类型安全的文件路由	开始阅读
08	Pinia 4：状态、Getter、Action、订阅与持久化	开始阅读
09	进阶能力：浅层响应式、原始对象、Teleport 与 Suspense	开始阅读

2026 年的技术基线

以下版本是在 2026-08-31 核对 npm latest 标签后得到的快照。补丁版本会继续更新，实际项目应优先让最新的 create-vue 生成相互兼容的依赖，不必照抄补丁号。

工具	核对时的稳定版本	本系列采用的主版本
Vue	3.5.42	3.5
create-vue	3.23.0	3
Vite	8.2.2	8
Vue Router	5.3.0	5
Pinia	4.0.3	4
TypeScript	7.0.2	7

当前 Vue 3.5 中值得纳入日常写法的能力包括：响应式 Props 解构、useTemplateRef()、onWatcherCleanup()、数字形式的 deep 监听深度，以及 Vue 3.4 起推荐的 defineModel()。Vue Router 5 已把文件路由和类型生成能力合并进核心包；Vite 8 则改用 Rolldown 作为统一打包器。

阅读建议

第一次学习 Vue：按 01 → 09 顺序阅读。
已会 Vue 2：重点阅读 02、03、05、07、08。
已在使用 Vue 3.2/3.3：重点关注 01、04、05、06、07，里面包含 3.4/3.5 之后的新写法。
只做中小型 SPA：Vue + Vite + Router + Pinia 足够；需要 SSR、服务端路由或全栈能力时，再评估 Nuxt，不必为“技术栈完整”而盲目增加框架。