Skip to content

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 请求通信:

Image

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

下图比较了这两种架构:

Image

浏览器在启动时只加载 一个几乎为空的页面——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. 示例

文档中的代码组织在三个文件夹中:

1
2
3
4
deliverable/
├── examples-vuejs/          the 20 small Vue.js examples
├── rdvmedecins-nestjs-json/ the RdvMedecins JSON server (the "black box")
└── rdvmedecins-vuejs/       the Vue.js client of the case study

examples 文件夹为每个示例包含一个子文件夹:

examples-vuejs/
├── 01-first-application/
├── 02-reactivity/
├── ...
├── 20-server-errors/
├── common/              code shared by examples 19 and 20
├── node_modules/
├── index.html           the table of contents of the examples
├── package.json
├── tsconfig.json
└── vite.config.ts

所有示例共用相同的库,这些库在 [examples-vuejs/package.json] 中声明。它们只需安装 一次,在打开到 [examples-vuejs] 文件夹的控制台中执行(在 [VS Code] 中:Terminal 菜单 / New Terminal):

npm install

然后启动 [Vite] 开发服务器:

npm run dev

一个服务器,在 5173 端口上,为全部二十个示例提供服务。地址 http://localhost:5173/ 显示它们的概览:

Image

你可以通过点击链接从一个示例跳转到另一个示例(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 服务器提供服务
-

每个示例都附有逐行注释的完整代码,以及运行时的截图。代码本身有大量注释:这些注释是课程的一部分。