ExpressJS - 环境

Express.js - 现代开发环境设置

Express.js 是一个精简灵活的 Node.js Web 应用程序框架，为 Web 和移动应用程序提供了一套强大的功能。要开始使用 Express 进行构建，你需要一个现代的 Node.js 开发环境。本指南将引导你完成设置。

核心开发工具

你的基本工具包将包括：

• **Node.js & npm：** JavaScript 运行时及其默认包管理器。
• **代码编辑器：** 强烈推荐使用像 Visual Studio Code (VS Code) 这样的现代编辑器，因为它内置了 JavaScript/TypeScript 支持、集成终端和庞大的扩展生态系统。
• **版本控制：** Git 是跟踪变更和协作开发代码的行业标准。
• **API 客户端：** 像 Postman、Insomnia 或 VS Code 的 Thunder Client 扩展等工具对于测试你的 API 端点至关重要。

步骤 1：使用版本管理器安装 Node.js

虽然你可以直接安装 Node.js，但使用像 nvm (Node 版本管理器) 这样的版本管理器是一种最佳实践。它允许你轻松地在不同项目之间切换不同的 Node.js 版本。

在 macOS / Linux 上安装（包括 Windows 上的 WSL）

打开你的终端并运行官方 nvm 安装脚本（请始终查阅 官方 nvm 仓库 以获取最新命令）：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

安装完成后，关闭并重新打开你的终端。然后，安装最新的长期支持 (LTS) 版本的 Node.js：

# 安装最新的 LTS 版本
nvm install --lts

# 将新安装的版本设置为默认
nvm use --lts
nvm alias default lts/gallium

在 Windows 上安装

对于 Windows，你可以使用 nvm-windows，这是一个单独但相似的工具。访问 nvm-windows 发布页面，下载 nvm-setup.zip 文件，然后运行安装程序。或者，通过使用适用于 Linux 的 Windows 子系统 (WSL) 并遵循上面的 Linux 说明来采用现代工作流程。

验证你的安装

检查 Node.js 和 npm 是否已正确安装。你应该会看到它们各自的版本号输出。

# 检查 Node.js 版本
node -v
# 预期输出: v20.11.0 (或你安装的 LTS 版本)

# 检查 npm 版本
npm -v
# 预期输出: 10.2.4 (或类似版本)

步骤 2：创建你的第一个 Express 项目

让我们初始化一个新项目。

1. **创建项目目录：**

mkdir my-express-app
cd my-express-app

2. **初始化 Node.js 项目：** 这会创建一个 package.json 文件来管理你项目的元数据和依赖项。

npm init -y

3. **初始化 Git 仓库：** 从一开始就进行版本控制是一个最佳实践。

git init
echo "node_modules/" > .gitignore

4. **安装 Express：** 将 Express 添加为项目依赖项。

npm install express

5. **安装开发依赖项：** nodemon 是一个工具，当你修改代码时，它会自动重启你的服务器，大大加快了开发速度。

npm install --save-dev nodemon

配置 npm 脚本

打开你的 package.json 文件，并在 "scripts" 部分添加 "start" 和 "dev" 脚本。这提供了一种标准的方式来运行你的应用程序。

package.json

{
  // ... 其他属性
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1",
    "start": "node src/index.js",
    "dev": "nodemon src/index.js"
  },
  // ... 其他属性
}

步骤 3：一个基本的“Hello World”服务器

创建一个 src 目录并在其中创建一个名为 index.js 的文件。

# 在你的终端
mkdir src
touch src/index.js

将以下代码添加到 src/index.js。这段代码导入 Express，创建一个应用程序，定义一个路由，并启动一个服务器。

src/index.js

import express from 'express';

const app = express();
const PORT = process.env.PORT || 3000;

app.get('/', (req, res) => {
  res.send('Hello, Modern World!');
});

app.listen(PORT, () => {
  console.log(`服务器正在运行于 http://localhost:${PORT}`);
});

注意：要使用 import/export 语法，请在 package.json 文件中添加 "type": "module"。

package.json

{
  "name": "my-express-app",
  "version": "1.0.0",
  "type": "module", // <-- 添加此行
  // ... 文件其余部分
}

运行你的服务器

现在，使用你创建的脚本运行你的开发服务器：

npm run dev

你应该会看到消息 服务器正在运行于 http://localhost:3000。打开你的 Web 浏览器并导航到该 URL。你将看到显示“Hello, Modern World!”。你的环境现在已设置完毕，可以进行开发了！