配置 Web 上的 URL 策略

Flutter Web 应用支持两种基于 URL 的 Web 导航配置方式：

哈希（默认） ：路径读取和写入到哈希片段。例如，flutterexample.dev/#/path/to/screen。

路径 ：路径读取和写入不包含哈希。例如，flutterexample.dev/path/to/screen。

要配置 Flutter 使用路径，请使用 Flutter SDK 中包含的flutter_web_plugins 库提供的usePathUrlStrategy 函数。

你不能直接使用 pub add 添加 flutter_web_plugins。将其作为 Flutter SDK 依赖项 包含在你的 pubspec.yaml 文件中：

dependencies:
  flutter:
    sdk: flutter
  flutter_web_plugins:
    sdk: flutter

然后在 runApp 之前调用 usePathUrlStrategy 函数：

import 'package:flutter_web_plugins/url_strategy.dart';

void main() {
  usePathUrlStrategy();
  runApp(ExampleApp());
}

PathUrlStrategy 使用History API，这需要对 Web 服务器进行额外的配置。

要配置你的 Web 服务器以支持 PathUrlStrategy，请查看你的 Web 服务器的文档以重写对 index.html 的请求。查看你的 Web 服务器的文档，了解如何配置单页应用程序的详细信息。

如果你使用的是 Firebase 托管，在初始化项目时选择“配置为单页应用程序”选项。有关更多信息，请参阅 Firebase 的配置重写 文档。

通过运行 flutter run -d chrome 创建的本地开发服务器已配置为优雅地处理任何路径并回退到你的应用程序的 index.html 文件。

将 web/index.html 中的 <base href="/"> 标签更新到你应用托管的路径。例如，要在 my_app.dev/flutter_app 托管你的 Flutter 应用，请将此标签更改为 <base href="/flutter_app/">。

相对 base href 标签支持发布版本，但它们必须考虑提供页面的完整 URL。这意味着对 /flutter_app/、/flutter_app/nested/route 和 /flutter_app/nested/route/ 的请求的相对 base href 将有所不同（例如，分别为 "."、".."和"../.."）。

除非另有说明，否则本网站上的文档反映的是 Flutter 的最新稳定版本。页面最后更新于 2025-01-30。 查看源代码 或 报告问题。