Node.js/Express大量路由的优雅管理方案咨询

我正在学习Node.js/Express，已掌握基础路由的使用方式，示例代码如下：

const productsRouter = require('./routes/products');
const employeesRouter = require('./routes/employees');

app.use('/products', productsRouter);
app.use('/employees', employeesRouter);

现咨询：当存在数十个路由时，是否必须创建数十个模块并重复编写上述代码？有无更简洁优雅的解决方案？

当然不需要重复编写冗余代码，通过自动遍历路由目录批量注册的方式就能优雅解决这个问题，下面是两种实用方案：

方案一：用Node.js原生fs模块实现自动遍历 #

编写一段工具逻辑，自动读取routes目录下的所有路由文件，并根据规则自动挂载路由：

const fs = require('fs');
const path = require('path');

const routesDir = path.join(__dirname, 'routes');
// 同步读取路由目录下的所有文件
fs.readdirSync(routesDir).forEach(file => {
  // 跳过非JavaScript文件（若用TypeScript可改为.ts）
  if (!file.endsWith('.js')) return;
  // 提取路由名称（比如products.js → products）
  const routeName = file.slice(0, -3);
  // 导入对应路由模块
  const router = require(path.join(routesDir, file));
  // 自动挂载路由，路径与文件名对应
  app.use(`/${routeName}`, router);
});

这种方式的优势是新增路由无需修改注册代码——只要新建orders.js，就会自动挂载到/orders路径。

如果需要自定义路由路径（比如文件名是user-auth.js但想挂载到/auth），可以在路由文件中导出自定义路径：

// routes/user-auth.js
const express = require('express');
const router = express.Router();

// 自定义路由路径
router.path = '/auth';

// 路由逻辑代码...

module.exports = router;

再修改遍历逻辑适配自定义路径：

fs.readdirSync(routesDir).forEach(file => {
  if (!file.endsWith('.js')) return;
  const router = require(path.join(routesDir, file));
  // 优先使用自定义路径，否则用文件名生成路径
  const routePath = router.path || `/${file.slice(0, -3)}`;
  app.use(routePath, router);
});

方案二：借助第三方库简化操作 #

如果不想自己处理文件遍历细节，可以用成熟的第三方库，比如require-dir：

1. 先安装依赖：

npm install require-dir

2. 在主文件中使用：

const requireDir = require('require-dir');
// 一次性导入routes目录下所有模块
const routes = requireDir('./routes');

// 遍历并挂载所有路由
Object.keys(routes).forEach(routeName => {
  const router = routes[routeName];
  const routePath = router.path || `/${routeName}`;
  app.use(routePath, router);
});

注意事项 #

• 保持路由目录结构清晰，可通过过滤文件名（比如只处理以-router.js结尾的文件）或分类子目录，避免无关文件被误加载。
• 若需嵌套路由（比如/api/v1/products），可通过递归遍历目录结构自动生成层级路径，或在路由文件中定义完整路径。

内容的提问来源于stack exchange，提问作者Zoë De La Jarretière