1. 引言
本文档的 PDF 在 这里。
本文档的代码在 这里。
本文档由 Anthropic 的 AI Claude 制作。它承接课程 “NestJS Web 框架分步入门”,并在此基础上 转换了视角:
- 在课程 [NestJS] 中,服务器 生成 HTML 页面(视图引擎 [Handlebars]);浏览器只负责显示它们;
- 在本课程中,页面由 浏览器中 的应用 [Vue.js] 生成;服务器现在只是一个简单的 JSON 服务器,仅提供数据。
不过,应用的页面保持不变:它们就是其他框架中已经介绍过的 [RdvMedecins] 应用的页面(带验证码的登录、医生日程、预约窗口、患者门户、医生和客户管理、账户创建、法语和英语)。
本文档与前几份文档结构相同:首先是 大量简短的示例,每个示例聚焦 [Vue.js] 的一个具体概念,然后是一个完整的 案例研究——即 [Vue.js] 客户端,对应 [RdvMedecins] 应用——所有文件都有完整的注释。
关于 [Vue.js],已经有两门课程:“通过示例学习 VUE.JS 框架入门”(2019),针对 [Vue.js] 2 编写;以及 “Vue.js 客户端/服务器 / NestJS 示例(2026)”,同时涵盖服务器和客户端。本文档在方法上与它们不同:服务器被视为 黑盒,我们只关心其 API 和 JSON,并在着手完整客户端之前 分步学习 [Vue.js] 。
1.1. Vue.js 在 Web 应用中的角色
应用由两部分组成,它们之间只通过 HTTP 请求通信:

- 1:在浏览器中运行的 [Vue.js] 应用向服务器发送 HTTP 请求,例如 [GET /api/schedule?doctorId=1&day=2026-10-05];
- 2:服务器以 JSON 数据作为响应:即该医生当天的日程。它不生成任何页面;
- 3:利用这些数据,[Vue.js] 无需重新加载即可更新浏览器中显示的页面。
下图比较了这两种架构:

浏览器在启动时只加载 一个几乎为空的页面——HTML。其余一切都由 [JavaScript] 代码生成:这就是所谓的单页应用(SPA,即 [Single Page Application])。当用户点击内部链接时,不会向服务器请求页面:[Vue.js] 路由器 会更改显示的 URL 并替换页面内容。
[Vue.js] 是 Evan You 于 2014 年创建的 [JavaScript] 框架。它基于两个理念:
- 组件:界面被拆分为可复用的部分(导航栏、表单字段、确认窗口等),每个部分写在一个 [.vue] 文件中,该文件包含其 HTML、代码和样式;
- 响应式: 组件的数据是“被观察”的。当其中任何数据发生变化时,[Vue.js] 会自动更新页面中显示该数据的部分。我们从不编写直接修改页面的代码。
我们将使用 [Vue.js] 3,用 [TypeScript] 编写,采用其最新的写法:组合式 API 以及 [<script setup>] 标签。
1.2. 所用工具
示例使用以下工具编写和测试(其安装方法见附录):
- [Node.js] 22(或至少 20.19)及其包管理器 [npm];
- 编辑器 [Visual Studio Code],并安装扩展 [Vue (Official)];
- 一款较新的浏览器([Chrome]、[Firefox]、[Edge]),最好安装扩展 [Vue.js devtools];
- 命令行工具 [curl],用于显示原始的 HTTP 响应;
- 数据库管理系统 [MySQL] (或 [MariaDB]),例如 [Laragon] 在 [Windows] 下附带的那个:JSON 服务器需要它,详见介绍该服务器的章节。
所用的库就是 [package.json] 文件中的那些:[Vue.js] 3.5、[Vite] 7(开发和构建工具)、[vue-router] 4(路由器)、[Pinia] 3(共享状态)、[vue-i18n] 11(多语言)、[TypeScript] 5.9、[Bootstrap] 5.3。
1.3. 示例
文档中的代码组织在三个文件夹中:
examples 文件夹为每个示例包含一个子文件夹:
所有示例共用相同的库,这些库在 [examples-vuejs/package.json] 中声明。它们只需安装 一次,在打开到 [examples-vuejs] 文件夹的控制台中执行(在 [VS Code] 中:Terminal 菜单 / New Terminal):
然后启动 [Vite] 开发服务器:
一个服务器,在 5173 端口上,为全部二十个示例提供服务。地址 http://localhost:5173/ 显示它们的概览:

你可以通过点击链接从一个示例跳转到另一个示例(http://localhost:5173/01-first-application/、http://localhost:5173/02-reactivity/...)。[Vite] 服务器无需重启:每个被修改并保存的文件都会立即重新编译,浏览器页面也会自动更新。你可以在控制台中输入 [Ctrl-C] 来停止它。
示例 17 至 20 会查询 JSON 服务器和 [RdvMedecins] 服务器:你需要先安装并运行它们,具体方法见专门介绍它们的章节。
1.4. 文档内容
章 | 内容 | 示例 |
入门 | Vite 项目、响应式、指令、事件、表单、验证 | 01 至 06 |
组件 | props、事件、v-model、插槽、生命周期、组合式函数、确认对话框 | 07–12 |
路由 | 路由器、导航守卫 | 13 和 14 |
共享状态 | Pinia store | 15 |
国际化 | 法语和英语双语应用 | 16 |
服务器:一个黑盒 | JSON 服务器的安装、其 API、curl 示例 | - |
与服务器交互 | fetch、连接与 Cookie;API 访问层;服务器错误 | 17–20 |
案例研究 | RdvMedecins 应用的 Vue.js 客户端 | - |
部署 | 编译后的客户端,由 JSON 服务器提供服务 | - |
每个示例都附有逐行注释的完整代码,以及运行时的截图。代码本身有大量注释:这些注释是课程的一部分。