Modern.js 项目中 Windows 路径导致的 TS 检查器正则表达式错误解析

问题背景

在使用 Modern.js 脚手架创建新项目并运行开发服务器时，部分 Windows 用户遇到了一个特殊的正则表达式错误。该错误表现为构建过程中抛出"Invalid regular expression"异常，导致开发服务器无法正常启动。

错误现象

错误信息显示，在构建过程中 watchpack 模块尝试创建一个正则表达式时失败，具体错误为"Unmatched ')'"。从堆栈跟踪可以看出，问题发生在处理 node_modules 路径的正则表达式构建阶段。

问题根源

经过技术团队分析，这个问题源于 Windows 系统路径中的反斜杠()与正则表达式特殊字符的冲突。在 Windows 环境下，文件路径使用反斜杠作为分隔符，而反斜杠在正则表达式中是转义字符。当路径被直接用于构建正则表达式时，会导致语法错误。

临时解决方案

对于遇到此问题的开发者，可以采取以下临时解决方案：

1. 关闭 TypeScript 类型检查器
2. 在项目配置文件中添加以下设置：

{
  output: {
    disableTsChecker: true
  }
}

技术原理深入

这个问题的本质在于路径处理时的平台兼容性问题。Modern.js 底层使用 Rspack 构建工具，而 Rspack 又依赖 watchpack 进行文件监视。在 Windows 系统上，当路径被转换为正则表达式模式用于忽略 node_modules 目录时，路径中的反斜杠被错误地解释为正则表达式的转义字符，而不是字面量。

修复进展

Modern.js 技术团队已经识别了这个问题，并在相关依赖库中提交了修复代码。修复方案主要涉及：

1. 对 Windows 路径进行规范化处理
2. 在构建正则表达式前正确转义路径分隔符
3. 确保跨平台路径处理的兼容性

最佳实践建议

对于 Modern.js 用户，建议：

1. 关注项目更新，及时升级到包含修复的版本
2. 在 Windows 开发环境中，可以考虑使用 WSL 或配置项目使用正斜杠路径
3. 对于关键项目，建议在 CI/CD 环境中使用 Linux 系统进行构建

总结

这个案例展示了跨平台开发工具中常见的路径处理问题。Modern.js 团队已经快速响应并提供了解决方案，体现了该项目对开发者体验的重视。随着修复版本的发布，Windows 用户将能够获得与其他平台一致的无缝开发体验。