ExpressJS - 安装

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

欢迎开启您的 Express.js 之旅！在您开始构建强大的 Web 应用程序之前，您需要一个可靠的开发环境。本指南将引导您设置一个现代、专业的 Node.js 项目。

唯一的前提条件是 Node.js 及其包管理器 npm，它们与 Node.js 捆绑在一起。要验证它们是否已安装，请打开您的终端并运行：

# 检查 Node.js 版本
node -v
# 推荐 v18.18.0 或更高版本

# 检查 npm 版本
npm -v
# 推荐 v9.8.1 或更高版本

使用 npm 初始化项目

每个 Node.js 项目都始于 package.json 文件。此文件是您项目的核心，包含元数据（如项目名称和版本），最重要的是，它列出了项目的所有依赖项。

步骤 1：创建项目目录 为您的项目创建一个新文件夹并进入该文件夹。

mkdir hello-world
cd hello-world

步骤 2：初始化项目 运行 npm init 命令。它会问您一系列问题以创建 package.json 文件。您可以按 Enter 键接受默认值，或使用 -y 标志跳过所有问题。

# 交互式设置
npm init

# 或者，立即接受所有默认值
npm init -y

这会创建一个类似如下的 package.json 文件：

{
  "name": "hello-world",
  "version": "1.0.0",
  "description": "",
  "main": "index.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "keywords": [],
  "author": "",
  "license": "ISC"
}

安装依赖项

步骤 3：安装 Express 现在，让我们安装 Express 框架。我们将使用 npm install 命令。该包将被下载到 node_modules 目录中，并会创建一个 package-lock.json 文件，以锁定依赖项的确切版本，从而确保跨环境的一致性。

# 安装 Express 并将其添加为 package.json 中的依赖项
npm install express

运行此命令后，您的 package.json 将更新并新增一个 dependencies 部分：

"dependencies": {
  "express": "^4.18.2"
}

使用 Nodemon 简化开发

在开发过程中，您会不断修改文件。每次手动停止和重启服务器是件繁琐的事情。nodemon 是一个工具，当它检测到文件更改时，会自动重启您的 Node.js 应用程序。

最佳实践：将 nodemon 等开发工具作为开发依赖项安装。它们仅在开发期间需要，而不在最终生产应用程序中使用。请使用 --save-dev（或 -D）标志。

npm install --save-dev nodemon
# 或更短的版本
npm i -D nodemon

使用 npm 脚本实现专业工作流

不是直接运行 node index.js 或 nodemon index.js 等命令，标准做法是在 package.json 的 scripts 部分定义它们。这使得您的项目对您和他人来说都更易于使用。

按如下方式更新您的 package.json 的 scripts 部分：

"scripts": {
  "start": "node index.js",
  "dev": "nodemon index.js",
  "test": "echo \"Error: no test specified\" && exit 1"
}

现在您可以使用这些简单的命令：

npm start：以生产模式运行您的应用程序。
npm run dev：以开发模式运行您的应用程序，并使用 nodemon 进行自动重启。

最终最佳实践：版本控制

在您编写任何代码之前，最好初始化一个 Git 仓库来跟踪您的更改。

# 初始化 Git 仓库
git init

# 创建 .gitignore 文件以排除 node_modules 和其他冗余文件
# 将 'node_modules/' 和其他文件（如 .env）添加到您的 .gitignore 中