背景
在前端开发项目中，经常需要搭建本地服务器用于开发和测试。虽然现在很多前端框架都提供了本地服务器的功能，但是这些本地服务器功能使用起来很容易出现问题，比如配置比较复杂或者不够灵活，缺少一些必要的功能。为此，@hodgepodge-node/server 这个 npm 包应运而生。
简介
@hodgepodge-node/server 是一个用于搭建本地服务器的 npm 包，其最大的优势在于它功能强大、易于配置、套路清晰、使用简单。它支持多种常用的开发需求，如静态文件服务、Mock 数据模拟、代理请求等。此外，它还可以对请求进行拦截，修改请求内容、响应内容，做到对服务器请求的完全掌控。使用 @hodgepodge-node/server，可以轻松搭建一台自己的本地服务器，并满足日常开发需求。
安装
在开始之前，请确保你已经安装了 Node.js 和 npm。在终端中运行以下命令：
npm install -g @hodgepodge-node/server
安装后，你便可以在命令行中使用 @hodgepodge-node/server 命令来启动本地服务器。
使用方法
命令行参数
在运行 @hodgepodge-node/server 命令时，可以给它传递一些参数，以配置服务器的相关行为。以下是一些常用的命令行参数：
-p/--port：指定服务器运行的端口。默认为3000。-d/--directory：指定服务器所提供的文件目录。默认为当前目录。-m/--middleware：指定服务器所使用的中间件。默认为[static]。-c/--config：指定服务器的配置文件路径。默认为hodgepodge.config.js。-h/--help：查看帮助信息。
示例：
@hodgepodge-node/server -p 8080 -d ./dist -m [static, mock] -c ./config/server.config.js
其中，该命令将启动一个端口号为 8080 的服务器，它的文件目录为 ./dist，使用的中间件包括 static 和 mock，配置文件路径为 ./config/server.config.js。
配置文件
如果你不想通过命令行手动输入参数，也可以通过配置文件来指定服务器的相关配置。
在根目录下新建 hodgepodge.config.js 文件，内容如下：
module.exports = { port: 8080, directory: './dist', middleware: ['static', 'mock'], config: './config/server.config.js' }
该配置文件将启动一个端口号为 8080 的服务器，它的文件目录为 ./dist，使用的中间件包括 static 和 mock，配置文件路径为 ./config/server.config.js。
中间件
@hodgepodge-node/server 内置了一些常用的中间件，通过在命令行参数中或配置文件中指定中间件名称，即可开启对应的中间件功能。如果你需要更丰富的中间件接入，也可以编写自己的中间件并使用。
以下是@hodgepodge-node/server 目前支持的中间件：
static
开启静态文件服务，使得前端项目可以通过本地服务器访问到静态文件。
例如，启动基本的静态文件服务：
@hodgepodge-node/server -m static
mock
模拟数据接口，使得前端项目可以通过本地服务器模拟 API 接口。
例如，创建一个 book.json 文件，它的内容是：
{ "id": 1, "name": "三体", "price": 35.0 }
在 hodgepodge.config.js 文件中配置 mock 中间件：
module.exports = { middleware: ["mock"] }
然后在 ./mock 目录下创建一个 books.js 文件，它的内容如下：
module.exports = { "GET /api/books/1": './book.json' }
其中，GET /api/books/1 是模拟的请求路径，./book.json 是对应的返回数据。这时访问 http://localhost:3000/api/books/1 即可得到返回数据。
拦截器
@hodgepodge-node/server 允许对请求进行拦截，修改请求内容、响应内容，做到对服务器请求的完全掌控。
在 ./interceptor 目录下创建一个 token.js 文件，它的内容如下：
-- -------------------- ---- ------- -------------- - -------- --------- - ------ ----- -------- ----- ---- - ----- ----- - ------------------------------ -- -------- - ------ ------------ ---- - ----- ------ - ----- --------------------------------------------- - -------- - ---------------- ----- - -- -- -------------- --- ---- - ------ ------------ ---- - ---- - ------ ------------- ------------ - - -展开代码
该拦截器的作用是对请求中的 Authorization 字段进行校验，如果验证通过就放行请求，否则返回 not authorized。
在 hodgepodge.config.js 文件中配置拦截器：
module.exports = { interceptor: ['./interceptor/token.js'] }
这样，当有请求进来的时候，就会自动执行 token.js 中的拦截器。
总结
@hodgepodge-node/server 是在前端开发中十分实用的工具，其灵活的配置方式和丰富的中间件功能可帮助开发者在本地开发环境中更好地进行开发和测试，提高开发效率和代码质量。我们可以根据项目需求定制化配置，完成一些不同的开发场景下的开发需求。希望这篇教程能够帮到您。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/111752
