13. 附录
13.1. 安装 Node.js
[Node.js] 可以从 nodejs.org 下载:选择 LTS(长期支持)24 版本,或从 22.22 起的 22 版本:这是 [React Router] 8 的要求([Vite] 8 只要求 20.19)。[Windows] 安装程序也会安装 [npm]。请在控制台中验证安装:
若要在同一台机器上运行多个版本的 [Node.js] ,可以使用 [nvm-windows] (在 [Windows] 下)或 [nvm](在 [Linux] 和 [macOS] 下)。
示例和案例研究总体上不需要安装任何工具:[Vite]、[TypeScript] (对于服务器,还有 [nest] 工具)都是每个项目依赖项的一部分,由 [npm install] 安装。[package.json] 中的脚本([npm start]、[npm run build])会在 [node_modules] 文件夹中找到它们。若要自己创建新项目,可以使用 [npm create vite@latest my-project -- --template react-ts] ,无需安装任何东西。
13.2. 安装 Visual Studio Code
[Visual Studio Code] 可以从 code.visualstudio.com 下载。它默认就支持 JSX 和 [TypeScript]:代码补全、边输入边检查类型、从组件([<InputField>])跳转到它的定义,以及在整个项目中重命名某个 prop。不需要任何扩展;你可以在扩展面板(Ctrl-Shift-X)中添加 ESLint (以及规则 [eslint-plugin-react-hooks],它会标出 [useEffect] 中缺失的依赖项和被有条件调用的 Hook)。
通过 File / Open Folder 菜单打开一个项目(例如 [examples-react] 文件夹),并通过 Terminal / New Terminal 菜单在其中打开一个控制台。
13.3. React Developer Tools 扩展
React Developer Tools 扩展可以从 [Chrome]、[Edge] 或 [Firefox] 的扩展商店安装。它会在浏览器的开发者工具(F12)中添加两个选项卡:
- “Components”:页面的组件树(而不是 HTML 标签树),以及每个组件的 props、状态和 Hook([useState]、[useContext]……)及其值;还有渲染它的那个组件;
- “Profiler”:一个记录器,显示每次更新时哪些组件被重新渲染、原因(“props changed”、“hook 2 changed”等)以及耗时多久。
你可以在那里修改某个 prop 或状态并观察页面更新:这是理解组件何时以及为何被重新渲染的绝佳方式。“Highlight updates when components render”选项会让每个被重新渲染的组件在页面上闪烁。
13.4. 用 Laragon 安装 MySQL
JSON 服务器需要 [MySQL] (或 [MariaDB])。[Laragon] (laragon.org)会在 [Windows] 下安装其中一个,开箱即用,并附带 [HeidiSQL] 管理工具。安装之后:
- “Start All”按钮会在 3306 端口启动 [MySQL] 服务器;
- 用户 [root] 没有密码:这些是服务器 [.env.example] 文件中的默认值;
- 在 [HeidiSQL] 中(“Database”按钮),File / Run SQL File 菜单项会运行 [database/dbrdvmedecins2.sql] 脚本。
在 [Linux] 或 [macOS] 下,使用系统的包管理器安装 [MySQL] 或 [MariaDB] ,并用命令行客户端运行脚本:[mysql -u root -p < database/dbrdvmedecins2.sql]。
13.5. 安装 curl
[curl] 已包含在 [Windows] 10 和 11、[macOS] 以及大多数 [Linux] 发行版中。请检查它的版本:
本文档中使用的 [--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])没有这个问题。