用途:针对指定文件、功能或编译阶段中的 Rspack CPU/内存热点路径做性能优化,核心思路是先判断该路径随依赖/导出的基数变化,再看数据结构规模,避免在高基数结构上做全量扫描或复制。
基数顺序(越大越危险):dependency/export_info > module/exports_info/module_graph_module > chunk > chunk_group > entry/runtime。
主要能力: CPU 侧——避免重复计算与重复遍历,缓存哈希、标识符、依赖列表等稳定结果;为常见空、单项、无连接情况加快速路径;延迟收集、排序、字符串渲染和诊断构造;把变更拆为收集与应用两阶段批量提交;用索引、分桶降低算法复杂度;保持同步热点同步,并行需遵守 Rspack 并发模型(CPU 同步用 rayon,异步编排用 rspack_parallel)。 内存侧——减少字符串 churn、减少克隆与数据搬运、减少临时容器、按 key 形态选数据结构、避免提前物化大结构、把冷数据移出热结构。
使用方式:先定位目标与主导数据结构,估算热点规模,优先做小而可度量的改动。验证需运行相关聚焦测试;先执行 pnpm run build:cli:dev 再执行 pnpm run test:unit,且优化后必须跑完单测;提交前运行 pnpm run format:rs、pnpm run format:js 与 cargo clippy --workspace --all-targets --all-features,并总结热点、基数风险、所用手法及各项结果。
PR 与基准:优化完成后询问用户是否建 PR;若建,切到以 perf/ 开头的分支,用 perf(<scope>): <summary> 或 perf: <summary> 提交,推送后创建标题以 perf: 开头的 PR,正文说明改动、原因、所涉热点与基数风险、预期 CPU/内存收益,不含 Validation 段。PR 存在后用 gh workflow run 'Ecosystem Benchmark' -f pr=<pr-number> 触发基准,并用 gh run list --workflow 'Ecosystem Benchmark' --limit 5 查看;允许等待时对比报告中的改进与回归,必要时再做一轮优化并重跑。
限制:具体版本、平台与价格未提供;优化不得改变可观察输出;加并行前应先消除重复串行工作;加缓存须明确生命周期与失效边界。