Mocha 不支持在 describe 块内直接使用 await import() 加载 ESM 测试模块，因其异步执行与 Mocha 同步构建测试树的机制冲突；推荐改用顶层静态导入 + 函数式测试套件导出的方式实现模块化组织。
王 mocha 不支持在 `describe` 块内直接使用 `await import()` 加载 esm 测试模块，因其异步执行与 mocha 同步构建测试树的机制冲突；推荐改用顶层静态导入 + 函数式测试套件导出的方式实现模块化组织。
在从 CommonJS 迁移至 ES 模块（ESM）的过程中，许多开发者尝试沿用原有模式——在 describe 回调中动态导入测试文件，例如：
describe('functional tests', async function() {
await import('./function/test.spec.js'); // ❌ 不生效：0 passing (0ms)
});
但该写法无法正常运行。原因在于：
- Mocha 在启动阶段即同步解析并注册所有 describe/it 声明，构建测试树；
- await import() 是异步操作，其内部的 it/describe 调用发生在 Mocha 完成测试发现（test discovery）之后，因此被完全忽略；
- 即使导入成功，模块中的测试定义也不会被 Mocha 捕获。
✅ 正确解法：顶层静态导入 + 函数式测试套件封装
将每个测试文件重构为默认导出一个接收 describe 上下文的函数，并在主测试入口文件中通过顶层 import 引入并显式调用：
✅ ./unit/test.spec.js（ESM 测试模块）
export default function() {
it('should equal 1 to 1', () => {
assert.strictEqual(1, 1);
});
it('should handle basic math', () => {
assert.strictEqual(2 + 2, 4);
});
}
✅ 主测试入口（如 test/index.spec.js）
import unitSuite from './unit/test.spec.js';
import functionalSuite from './functional/test.spec.js';
describe('Unit Tests', unitSuite);
describe('Functional Tests', functionalSuite);
// 可继续添加更多套件...
⚠️ 注意事项：
- 确保 Node.js ≥ v14.8.0，并以 .mjs 扩展名或 type: "module" 在 package.json 中启用 ESM；
- 所有测试文件必须是纯 ESM（无 require/module.exports），且 assert 需从 'node:assert' 显式导入（若未全局注入）；
- 不要使用 async describe 或 await import() 在测试块内——这是根本性不兼容的设计，非 bug 而是机制限制。
这种模式不仅完全复现了 CommonJS 下的模块化能力，还更符合 ESM 的静态分析特性，提升了可维护性与工具链兼容性（如 TypeScript、Vitest 等）。最终效果：测试数量准确识别、钩子（beforeEach 等）正常触发、报告完整可靠。
