使用 TypeScript 从零搭建自己的 Web 框架：文件扫描与动态导入

在构建 Web 框架的过程中，文件扫描与动态导入是一个核心环节。通过扫描特定文件夹（如 controller 文件夹）中的文件，并自动将它们导入到框架中，可以极大地提高框架的灵活性和可扩展性。本文将详细介绍如何使用 TypeScript，结合 fast-glob 库和动态 import 语法，从零搭建一个具有文件扫描与自动导入功能的 Web 框架。

一、fast-glob 介绍

fast-glob 是一个用于文件搜索的 Node.js 库，它提供了高效的 glob 模式匹配和文件搜索功能。与 Node.js 内置的 glob 模块相比，fast-glob 更加快速且功能丰富。它支持多种 glob 模式，可以方便地匹配和搜索项目中的文件。

安装 fast-glob 可以通过 npm 或 yarn 进行：

npm install fast-glob
# 或者
yarn add fast-glob

二、动态导入

在 TypeScript 中，动态导入是通过 import() 函数实现的，它返回一个 Promise 对象，该对象在模块加载完成时解析为模块的导出内容。这种导入方式允许你在运行时决定导入哪个模块，非常适合于实现按需加载或代码分割等场景。

三、实现文件扫描与自动导入

接下来，我们将通过编写一个 async main 函数，使用 fast-glob 扫描 controller 文件夹中的所有控制器文件，并通过动态 import 将它们导入到框架中。

首先，我们需要在项目的根目录下创建一个 TypeScript 文件（例如 main.ts），并编写 async main 函数：

import fg from 'fast-glob';
import path from 'path';

// 定义异步 main 函数
async function main() {
  try {
    // 定义 controller 文件夹的路径
    const controllerPath = path.join(__dirname, 'controller/**/*.js');

    // 使用 fast-glob 扫描 controller 文件夹中的所有 .ts 文件
    const controllerFiles = await fg(controllerPath);
    console.log('找到的控制器文件：', controllerFiles);

    // 遍历文件列表，使用动态 import 导入每个文件
    for (const file of controllerFiles) {
      // 动态导入模块
      const controllerModule = await import(file);
      console.log('导入的控制器模块：', controllerModule);

      // 在这里，你可以将 controllerModule 添加到你的框架的IoC容器或其他逻辑中
    }
  } catch (err) {
    // 捕获并处理任何错误
    console.error('文件扫描或导入过程中发生错误：', err);
  }
}

// 执行 main 函数
main().catch(err => {
  console.error('主函数执行失败：', err);
});

在上面的代码中，我们首先使用 path.join 方法构建了一个指向 controller 文件夹的 glob 模式字符串。然后，我们调用 fg 函数来搜索匹配该模式的所有文件，并将结果保存在 controllerFiles 数组中。

接下来，我们遍历 controllerFiles 数组，并使用 import() 函数动态导入每个文件。由于 import() 返回一个 Promise，我们使用 await 关键字等待每个模块的导入完成。一旦模块被导入，我们就可以将其添加到框架的相应部分中，例如注册到路由系统中。

四、总结

通过结合 fast-glob 和动态 import，我们可以轻松地实现文件扫描与自动导入功能，从而构建一个灵活且可扩展的 Web 框架。