Waku框架中fsRouter路径参数变更解析

在Waku框架的最新更新中，fsRouter函数的使用方式发生了一个重要变化。作为项目核心路由功能的关键组件，这一变更直接影响到了开发者的项目配置方式。

变更背景

fsRouter是Waku框架中负责文件系统路由的核心功能。在之前的版本中，该函数的第三个参数（pages目录路径）是可选的。但在最近的代码提交中，开发团队将其调整为必填参数，这属于一个破坏性变更(breaking change)。

具体变更内容

新版本的fsRouter现在严格要求开发者显式指定pages目录的路径。如果未提供该参数，系统会抛出类型错误："The 'path' argument must be of type string. Received undefined"。

正确的使用方式现在应该是：

export default fsRouter(
  import.meta.url,
  (file: string) => import.meta.glob("./pages/**/*.tsx")[`./pages/${file}`]?.(),
  "pages" // 必须显式指定pages目录路径
);

影响范围

这一变更主要影响：

1. 从旧版本升级的项目
2. 按照旧文档配置的新项目
3. 任何省略了第三个参数的使用场景

解决方案

对于遇到此问题的开发者，解决方案很简单：只需在调用fsRouter时添加第三个参数，明确指定pages目录的路径字符串即可。

最佳实践建议

1. 在项目升级时注意检查所有fsRouter调用点
2. 考虑将路径字符串提取为常量，便于统一管理
3. 对于团队项目，应在内部文档中注明这一变更

框架演进思考

这一变更反映了Waku框架向更明确、更严谨的API设计方向演进。虽然带来了短期的适配成本，但从长远看有助于提高代码的可靠性和可维护性。作为开发者，理解框架的这种演进思路，有助于我们更好地把握技术方向，编写出更健壮的应用程序。