需接管字体加载链路：禁用uses-material-design，移除fonts.googleapis.com自动注入，在web/index.html中预加载本地CSS及字体文件，并在runApp()前用ui.FontCollection().load()注册字体。
如何让Flutter Web不依赖fonts.googleapis.com加载字体
默认情况下，Flutter Web会通过https://fonts.googleapis.com/css2?family=...动态注入Google Fonts CSS，这在内网、离线或国内弱网环境下必然失败，直接导致白屏或文字渲染异常。关键不是“禁用字体”，而是接管字体加载链路，把远程请求转为本地资源。
常见错误现象包括：Failed to load resource: net::ERR_CONNECTION_REFUSED（对应css2?family=...）、文字显示为方块、控制台反复报Font not available警告。
- 先确认你实际用到的字体族名：比如
Noto+Sans+SC（简体中文）、Roboto（默认UI字体），不要照搬示例中的Noto+Sans+JP - 手动下载对应CSS文件：访问
https://fonts.googleapis.com/css2?family=Noto+Sans+SC&display=swap，复制返回的CSS内容（含@font-face规则） - 保存为
web/fonts/noto-sans-sc.css，并在web/index.html的<head>中用<link rel="stylesheet" href="fonts/noto-sans-sc.css">显式引入 - 确保CSS中所有
url(...)指向的.ttf或.woff2文件已下载并放在web/fonts/下，路径需与CSS里声明的一致
为什么修改main.dart.js里的字体URL不可靠
有人尝试搜索build/web/main.dart.js，把其中KFOmCnqEu92Fr1Me5WZLCzYlKw.ttf等URL替换成/fonts/xxx.ttf——这方法短期有效，但每次flutter build web都会重写该文件，手动改会被覆盖。更严重的是，Dart编译器可能在不同版本中改变字体引用方式（比如改用Base64内联或换哈希名），导致替换失效。
真正可控的做法是：从源头切断Flutter自动生成远程字体请求的行为。
立即学习“前端免费学习笔记（深入）”；
- 在
pubspec.yaml中移除uses-material-design: true（它会自动拉Roboto和Material Icons） - 如需Material Icons，改用本地字体文件：将
MaterialIcons-Regular.otf放入web/fonts/，并在web/index.html中通过@font-face注册，再在Dart中用IconData(0xe800, fontFamily: 'MaterialIcons')引用 - 禁用自动字体注入：在
main.dart入口前加window.document.querySelector('link[href*="fonts.googleapis.com"]')?.remove();（需dart:js）
deferred加载字体是否可行
不能。Dart的deferred机制只适用于.dart源码模块，而字体是Web运行时资源，由浏览器CSS引擎加载，与Dart执行流无关。试图用Future.delayed或FontLoader去“懒加载”字体，只会造成文字闪动或布局偏移（FOIT/FOUT问题）。
正确策略是预加载+缓存：
- 在
web/index.html中添加<link rel="preload" href="fonts/noto-sans-sc.woff2" as="font" type="font/woff2" crossorigin> - 确保服务器对
.woff2响应头包含Cache-Control: public, max-age=31536000 - 如果字体文件较大（>100KB），考虑用
font-display: swap避免阻塞渲染
CanvasKit模式下字体加载的特殊处理
当使用--web-renderer canvaskit时，Flutter会绕过浏览器原生字体栈，改用Skia渲染文本。此时即使你本地化了CSS，仍可能遇到字体未生效的问题——因为Canvaskit需要额外注册字体到其内部字体管理器。
必须配合Dart层注册：
import 'dart:ui' as ui;
void loadCustomFont() async {
final fontData = await rootBundle.load('fonts/NotoSansSC-Regular.ttf');
await ui.FontCollection().load(
ui.FontLoader('Noto Sans SC').addFont(fontData),
);
}
注意：ui.FontCollection().load()必须在runApp()之前调用，否则部分Widget（如Text）可能已用默认字体完成布局，后续注册无效。
容易被忽略的是：Canvaskit模式下，FontLoader注册的字体名必须与TextStyle.fontFamily完全一致（包括空格、大小写），且不能依赖CSS中定义的别名。
