Skip to content

13. 附录

13.1. 安装 Node.js

[Node.js] 可以从 nodejs.org 下载:选择 LTS(长期支持)版本,最好是 22([Vite] 7 至少需要 20.19 版本)。[Windows] 安装程序也会同时安装 [npm]。在控制台中验证安装:

node --version
npm --version

要在同一台机器上运行多个版本的 [Node.js] ,可以使用 [nvm-windows] (在 [Windows] 下)或 [nvm](在 [Linux] 和 [macOS] 下)。

示例和案例研究无需安装任何全局工具:[Vite]、[TypeScript]、[vue-tsc] (以及对于服务器而言的 [nest] 工具)都是每个项目依赖的一部分,由 [npm install] 安装。

13.2. 安装 Visual Studio Code

[Visual Studio Code] 可通过 code.visualstudio.com 下载。对于 [.vue] 文件,请在扩展面板(Ctrl+Shift+X)中安装 Vue (Official) 扩展(发布者 Vue.volar):提供语法高亮、代码补全、模板中的类型检查([TypeScript]),以及跳转到组件或 prop 的定义。

通过 File / Open Folder 菜单打开项目(例如 [examples-vuejs] 文件夹),并通过 Terminal / New Terminal 菜单在其中打开控制台。

13.3. Vue.js devtools 扩展

Vue.js devtools 扩展可以从 [Chrome]、[Edge]、或 [Firefox] 的扩展商店安装。它会在浏览器的开发者工具(F12)中添加一个“Vue”选项卡,其中显示:

  • 页面的组件树,以及每个组件的 props 和状态([ref]、[reactive]、[computed]);
  • [Pinia] store 及其内容;
  • 路由器的路由和当前路由;
  • 由组件触发的事件的时间线。

你可以在那里修改一项数据,并观察页面随之更新:这是理解响应式的绝佳方式。

13.4. 使用 Laragon 安装 MySQL

JSON 服务器需要 [MySQL] (或 [MariaDB])。[Laragon] (laragon.org)在 [Windows] 下安装其中一个,开箱即用,同时附带 [HeidiSQL] 管理工具。安装之后:

  • “Start All”按钮会启动 [MySQL] 服务器,端口为 3306;
  • 用户 [root] 没有密码:这些是服务器 [.env.example] 文件中的默认值;
  • 在 [HeidiSQL] 中(“Database”按钮),File / Run SQL 菜单项会运行 [database/dbrdvmedecins2.sql] 脚本。

在 [Linux] 或 [macOS] 中,使用系统的包管理器安装 [MySQL] 或 [MariaDB] ,并使用命令行客户端运行该脚本:[mysql -u root -p < database/dbrdvmedecins2.sql]。

13.5. 安装 curl

[curl] 包含在 [Windows] 10 和 11 版本、[macOS] 以及大多数 [Linux] 发行版中。检查它的版本:

curl --version

本文档中使用的选项 [--json] 自 7.82 版本(2022)起可用。如果你使用的是较旧的版本,请把 [--json @file] 替换为 [-H "Content-Type: application/json" -d @file],或者从 curl.se 安装较新的版本。

在 [PowerShell] 中,必须输入 [curl.exe],而不是 [curl]:在 [PowerShell] 中,[curl] 是另一条命令([Invoke-WebRequest])的别名,它不包含 [curl] 的那些选项。命令提示符([cmd])没有这个问题。