环境与约定

这节要解决什么

把工具装好，并约定这套资料里怎么写代码，避免后面各章节说法不一致。

先用大白话

• Node：让 JavaScript 能在电脑上跑（不只在浏览器里）。
• npm：装别人写好的包（类似前端的依赖安装）。
• TypeScript：带类型的 JS，改完要编译/由工具转成 JS 再跑。Nest 官方就按 TS 推。

你本机若已是 Node 18+（推荐 20/22），一般不用折腾。

动手检查

在终端执行：

node -v   # 建议 v20 或 v22
npm -v

进入本仓库根目录后，各项目都在 projects/ 下，进对应目录再 npm install。

本资料统一约定

1. 模块写法：Node 小项目用 ESM（import）；Nest 项目按 Nest 默认（同样是现代 TS import）。
2. 内置模块：优先写 node:fs、node:path 这种带 node: 前缀的形式，一眼能看出是 Node 自带的。
3. 端口：
   • Express 练习：3001
   • Nest 主项目：3000
   • Vue 联调：5173
4. 数据库：SQLite 文件，落在 Nest 项目里，不用单独装 MySQL/Postgres。
5. 注释：中文，讲「为什么」，不讲废话。

推荐编辑器小设置

• 安装 ESLint / Prettier 插件（可选）
• Nest / Vue 都用 VS Code / Cursor 即可
• 调试 Nest：用项目里的 start:dev（改代码自动重启）

验收清单

• node -v、npm -v 能输出版本
• 知道四个项目都在 projects/ 目录
• 清楚三个端口：3000 / 3001 / 5173

下一站 → 01-Node基础/01-运行时与模块.md