Suicrux性能优化清单:10大生产构建技巧让应用又快又省
Suicrux性能优化清单:10大生产构建技巧让应用又快又省
Suicrux 是一个内置 SSR(服务端渲染)、代码分割(lazy-loading) 和 i18n 国际化 的 React 通用启动模板(starter)。本文整理它生产构建中真正落地的 10 个性能优化技巧,全部有源码配置可查,照着检查自己的项目即可快速见效。
🚀 快速体验:
git clone --depth=1 --single-branch https://gitcode.com/gh_mirrors/su/suicrux
cd suicrux
npm install
npm run build # 生产构建(client + server)
npm run start # 启动 Node 服务端
技巧一:路由级懒加载,只下载当前页面
Suicrux 用 react-async-component:404 页面通过 import() 动态引入,浏览器只有访问到该路由时才下载对应 chunk;主页面 Dashboard 和 Links 直接打进首包,保证首屏速度。
💡 长尾关键词参考:React 路由懒加载、按需加载、code-splitting。
技巧二:提取 vendor 与 manifest chunk,最大化缓存命中
生产配置 webpack_config/client/webpack.prod.babel.js 用 CommonsChunkPlugin 把 node_modules 依赖单独抽成 vendor chunk,再抽出 manifest。第三方库很少变动,单独成块后浏览器可以跨版本长期缓存,更新时只下载业务代码。
技巧三:文件名加哈希,实现长期缓存(long-term caching)
webpack_config/client/webpack.base.js 中生产环境文件名形如 [name].[hash:6].js,内容一变哈希就变、旧文件自动失效,同时配合 Nginx 等配置 Cache-Control: max-age=31536000 实现一年强缓存——又快又省流量的关键一步。
技巧四:UglifyJs 压缩,顺手删掉 console.log
UglifyJsPlugin 开启了 unused、dead_code 压缩和 drop_console(见 webpack_config/client/webpack.prod.babel.js):
- 移除死代码和无用变量,直接减小包体积
- 生产包自动剔除
console.log,避免调试输出拖慢渲染
技巧五:Gzip 双重压缩,传输体积再砍 60%+
压缩做了两层:
- 构建期:
CompressionPlugin({algorithm: 'gzip'})预生成.gz文件(webpack_config/client/webpack.prod.babel.js) - 运行期:Express 挂载
compression中间件对响应实时 gzip(src/server/middlewares/index.js)
技巧六:CSS 抽取 + 压缩,不再阻塞渲染
生产环境用 ExtractTextPlugin 把 CSS 从 JS 里抽成独立文件 <a href="https://link.gitcode.com/i/c6994006f7f4d961b907034397c82179" target="_blank">name].[hash:6].css,再用 OptimizeCssAssetsPlugin 去掉全部注释并压缩([webpack_config/client/webpack.prod.babel.js)。CSS 独立后可并行下载,且同样享受哈希强缓存。
技巧七:Scope Hoisting,减少函数调用开销
ModuleConcatenationPlugin(即 scope hoisting / 模块拼接)会把 ES Modules 的多个模块合并到同一作用域,消除大量无意义的 wrapper 函数,既缩小体积又加快执行。客户端与服务端构建均已开启(webpack_config/server/webpack.prod.babel.js)。
技巧八:UI 样式按需引入,拒绝 548KB 全量 CSS
semantic-ui-css 全量样式约 548KB 且阻塞渲染。Suicrux 的做法是在入口 src/client/index.jsx 只 import 用到的组件 CSS(button、header、menu、loader 等 17 个文件),首屏样式体积大幅下降。README 的 Suicrux FAQ 也专门提示了这一点。
技巧九:Babel 生产优化——lodash 按需引入 + 移除 React 开发代码
查看 .babelrc:
babel-plugin-lodash:把import _ from 'lodash'转成具名导入,配合 tree-shaking 只保留用到的函数env.production启用react-optimizepreset:生产包移除React.Children校验、propTypes与devtools支持babel-plugin-styled-components开启ssr: true,保证 SSR 下样式不错位、不重复
技巧十:用 ANALYZE_BUNDLE 定位瓶颈 + Service Worker 离线缓存
- 设置环境变量
ANALYZE_BUNDLE=true后执行构建,webpack-bundle-analyzer会生成静态报告页,一眼找出体积异常的大模块(配置入口见 webpack_config/config.js) - 生产环境通过
OfflinePlugin注入 Service Worker,将vendor.*.js、manifest.*.js等核心资源缓存到本地,二次访问接近秒开(运行时逻辑见 src/common/pwa/index.js,且仅在 production 分支加载,见 src/client/index.jsx)
📋 性能检查清单速查
| # | 优化项 | 对应配置 |
|---|---|---|
| 1 | 路由懒加载 | src/common/routing/index.jsx |
| 2 | vendor/manifest 分包 | webpack_config/client/webpack.prod.babel.js |
| 3 | 文件名哈希强缓存 | webpack_config/client/webpack.base.js |
| 4 | UglifyJs 压缩去 console | 同生产配置 L64-L76 |
| 5 | Gzip 预压缩 + 中间件 | src/server/middlewares/index.js |
| 6 | CSS 抽取与压缩 | 生产配置 L51-L62 |
| 7 | Scope Hoisting | webpack_config/server/webpack.prod.babel.js |
| 8 | SUI 样式按需引入 | src/client/index.jsx |
| 9 | lodash 按需 + react-optimize | .babelrc |
| 10 | 包分析 + 离线缓存 | webpack_config/config.js、src/common/pwa/index.js |
📌 小结:这 10 个技巧覆盖了 体积(分包、压缩、按需引入)、传输(gzip、强缓存)、执行(scope hoisting、SSR) 三个维度。Suicrux 虽标注 not maintained,但它基于 Webpack 3 时代的成熟方案,思路对任何 React 生产构建都同样适用。