Park-UI 在 StackBlitz 中性能优化实践

问题背景

在使用 Park-UI 框架的 Solid Start 项目时，开发者遇到了 StackBlitz 环境下显著的性能问题。具体表现为开发服务器启动时间超过 100 秒，热模块替换(HMR)时间超过 20 秒。这种性能瓶颈严重影响了开发体验。

问题分析

经过深入调查，我们发现这个问题主要出现在以下场景：

1. 当使用 Park-UI 的预设(preset)配置 Panda CSS 时
2. 仅在 StackBlitz 环境中出现，本地开发环境表现正常
3. 与内存使用量相关(约消耗 2.4GB 内存)

值得注意的是，虽然最初怀疑是某些技术因素导致的问题，但实际分析显示这并非根本原因。

解决方案

经过社区讨论和验证，我们找到了有效的优化方案：

1. 显式排除 node_modules

在 Panda 配置中明确排除 node_modules 目录可以显著提升性能。这是因为：

• Panda 默认会扫描项目中的所有文件来提取样式使用情况
• node_modules 包含大量第三方代码，扫描这些文件不必要且耗时
• 在 StackBlitz 的虚拟文件系统环境中，这种扫描操作代价更高

配置示例：

// 在 panda.config.ts 中
export default defineConfig({
  // ...其他配置
  exclude: ['node_modules']
})

2. 环境特定优化

对于 StackBlitz 环境，还可以考虑以下优化措施：

• 减少同时扫描的文件数量
• 使用更精确的 include 配置，只包含实际需要样式提取的目录
• 考虑禁用部分开发时非必需的功能

实施效果

应用上述优化后：

• 开发服务器启动时间从 100+秒降至合理范围
• HMR 时间从 20+秒显著缩短
• 内存使用量得到控制
• 开发体验大幅改善

最佳实践建议

基于这次经验，我们建议在使用 Park-UI 时：

1. 始终显式配置 include/exclude 选项
2. 针对不同开发环境(本地/StackBlitz/CodeSandbox等)进行特定优化
3. 监控构建工具的内存使用情况
4. 定期检查 Panda CSS 的配置是否最优

总结

性能优化是前端开发中永恒的话题，特别是在在线开发环境如 StackBlitz 中。通过合理配置 Panda CSS 的文件扫描范围，我们成功解决了 Park-UI 在 StackBlitz 中的性能瓶颈问题。这一经验也提醒我们，在项目配置中考虑环境差异的重要性。