合并 2022 年两篇记录;原环境包含 Flutter 3.4.0 beta,不沿用旧渲染器参数。
2022 年的旧站经历了两次 Flutter Web 加载优化:第一次集中在字体与 CanvasKit 资源下载,第二次尝试延迟加载,并比较当时 HTML 与 CanvasKit 渲染器的取舍。
这些记录保留了定位问题的方法。原文的加载秒数没有统一的设备、网络和测量条件,不能直接用来承诺当前项目的性能。
先分清下载和渲染
首次加载涉及 HTML、启动脚本、编译产物、字体、图片以及渲染相关资源。某个 CDN 很慢、首屏一次加载过多页面、字体缺失,都可能让用户感觉页面长时间没有准备好。
原站将渲染资源放到自己的服务器,并配置项目字体,分别处理下载来源和文字显示问题。文章关闭后,原来的 neverouo.xyz/canvaskit/ 也不应继续成为其他应用的资源依赖。


用 deferred 延后非首屏模块
Dart 的 deferred import 可以在 Web 上按需加载库。原站把并非首屏需要的工具页单独延迟导入,在用户真正打开时再调用 loadLibrary()。
import 'tool_page.dart' deferred as tool_page;
class ToolRoute extends StatefulWidget {
const ToolRoute({super.key});
@override
State<ToolRoute> createState() => _ToolRouteState();
}
class _ToolRouteState extends State<ToolRoute> {
late final Future<void> _load = tool_page.loadLibrary();
@override
Widget build(BuildContext context) {
return FutureBuilder<void>(
future: _load,
builder: (context, snapshot) {
if (snapshot.hasError) {
return const Center(child: Text('页面加载失败,请重新打开'));
}
if (snapshot.connectionState != ConnectionState.done) {
return const Center(child: CircularProgressIndicator());
}
return tool_page.ToolPage();
},
);
}
}
Future 保存在 State 中,避免每次 build 都重新创建加载流程。工具页和它的重依赖也不能同时从其他首屏路径被直接引用,否则按需加载的收益会减少。
这里展示 Web 库延迟加载。旧文的 pubspec deferred-components 配置属于另一层平台机制,不作为 Web 的必需配置保留。

字体与资源按用途安排
flutter:
fonts:
- family: ProjectText
fonts:
- asset: assets/fonts/project-text.ttf
字体声明与 ThemeData 中使用的 fontFamily 保持一致。先加载首屏真正需要的字体与图片,大图和非首屏内容按需请求。字体授权和文件体积也会影响发布方式。
把资源放到自有域名能减少对外部下载地址的依赖,但需要与部署版本配套处理缓存和更新;资源可访问不等于首屏性能已经改善。
保留当时的取舍,区分现在的配置
原文在 Flutter 3.4.0 beta 背景下尝试 HTML 渲染器,观察到桌面加载变快,同时遇到部分 iPhone Safari 刷新异常,随后又转回 CanvasKit。这是当时多浏览器体验之间的取舍。
当前 Flutter Web 官方说明使用 CanvasKit 和 Skwasm。旧文章中的 --web-renderer html、旧 PWA 参数及固定 CanvasKit 下载地址不再作为当前构建指令展示。具体构建选项与项目 SDK 版本对应,延迟加载和控制首屏依赖的思路可以独立保留。


