简介
在 Web 开发中，Express 是一个非常流行的 Node.js Web 框架，它可以帮助开发者快速地构建 Web 应用。Express-generator 是一个快捷生成 Express 应用程序的命令行工具，使用它可以快速地生成一个基础的 Express 应用程序结构，并提供预设的文件夹结构、代码文件和一些基础的配置文件，加快了开发的速度。
在本文中，我们将介绍如何在 Node.js 中使用 Express-generator 生成项目模板，并详细讲解模板中各个文件及文件夹的作用，同时给出相应的示例代码。
安装
使用 Express-generator 之前需要先安装 Node.js 和 npm，安装步骤可参考官网。
安装 Express-generator 仅需在命令行中运行以下命令：
npm install -g express-generator
其中，"-g" 表示全局安装，安装后即可在任意目录下使用。
使用
使用 Express-generator 快速生成一个 Express 应用程序，只需在命令行中进入项目根目录，运行以下命令：
express myapp
其中，"myapp" 为项目名称，运行该命令后，Express-generator 将在当前目录下生成一个名为 "myapp" 的文件夹，这个文件夹就是基础的 Express 应用程序结构。
结构解析
生成的项目结构如下：
-- -------------------- ---- ------- ----- --- --- - --- --- -- ------ --- ------ -- ---------- ---- ---- - --- ------ - --- ----------- - --- ----------- --- ------ -- ------ - --- -------- - --- -------- --- ----- -- ------------ ----- - --- ---------- - --- ---------- - --- ----------- --- ------ -- -------- --- ------------ -- ----------- --- --------- -- ------
上述结构中的各个文件及文件夹的作用如下：
- bin：存放服务启动文件，这里生成一个 "www" 文件，运行该文件即可启动服务。
- public：存放静态文件，例如 js、css、img 等。
- routes：存放路由文件，这里生成的 "index.js" 和 "users.js" 文件分别为根路由和用户路由。
- views：存放模板文件，这里默认使用 Jade 模板引擎。生成的 "error.jade"、"index.jade"、"layout.jade" 分别为错误页面、首页和布局文件。
- app.js：应用程序的入口文件，包括服务的初始化、中间件的加载和路由处理等。
- package.json：应用程序的依赖及其他信息，其中主要包含应用程序的名称、版本号和所需的 Node.js 模块等。
- README.md：项目说明文档。
示例代码
生成的项目结构中默认集成了一些示例代码，可以快速入门，以下是代码主要部分的解释：
app.js
-- -------------------- ---- ------- -- ------- --- ----------- - ----------------------- --- ------- - ------------------- --- ---- - ---------------- --- ------------ - ------------------------- --- ------ - ------------------ -- ------ --- ----------- - -------------------------- --- ----------- - -------------------------- --- --- - ---------- -- ----- ---------------- -------------------- ---------- ------------- -------- -------- -- ------ ----------------------- ------------------------ ---------------------------- --------- ----- ---- ------------------------ ------------------------------------------- ------------ -- ----- ------------ ------------- ----------------- ------------- -- ---- --------------------- ---- ----- - ----------------------- --- --------------------- ---- ---- ----- - ------------------ - ------------ ---------------- - ------------------ --- ------------- - --- - --- --------------------- -- ----- -------------------- --- -------------- - ----
上述代码中，主要是对服务进行了配置与中间件的使用，以及路由的配置以及错误处理的配置，其中：
- 通过 app.set() 方法设置了项目的视图文件夹以及视图引擎为 Jade。
- 通过 app.use() 方法使用了一些中间件，例如日志中间件、JSON 响应中间件、url 编码中间件、cookie 解析中间件等。
- 使用 app.use() 方法设置路由，并通过 routes 文件夹中的 index.js 和 users.js 文件处理了根路由和用户路由。
- 错误处理使用了 createError 库抛出错误，并使用 res.render() 渲染错误界面。
routes/index.js
-- -------------------- ---- ------- --- ------- - ------------------- --- ------ - ----------------- -- --- ---- ----- -- --------------- ------------- ---- ----- - ------------------- - ------ --------- --- --- -------------- - -------
在默认的路由文件中，为根路由"/"编写了一个处理函数，通过 res.render() 方法渲染了 index.jade 模板并传递了数据 { title: 'Express' }，然后将渲染后的 HTML 页面返回给客户端。
views/layout.jade
doctype html
html
head
title= title
link(rel='stylesheet', href='/stylesheets/style.css')
body
block contentlayout.jade 是布局文件，它定义了整个页面的框架，所有生成的页面都使用该文件作为模板，由于模板使用了 jade 引擎，因此代码的缩进非常重要。
views/index.jade
extends layout
block content
h1= title
p Welcome to #{title}index.jade 将内容视为块，并将其包裹在 layout.jade 定义的框架内，使用了布局文件的 block 语句。在 index.jade 中，使用了 h1 和 p 标签显示了标题和欢迎信息。
总结
本文介绍了在 Node.js 中使用 Express-generator 生成项目模板的方法，并详细讲解了模板文件夹结构和示例代码的作用。使用 Express-generator 可以快速地生成一个基础的 Express 应用程序结构，为快速开发 Web 应用提供了很大的帮助。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/65191cc795b1f8cacd156aca