跳到主内容

文档新功能

docs.flutter.dev 及相关文档网站的更新列表。

此页面包含关于 Flutter 网站和博客最新内容的当前及近期公告。如需查看以往的更新信息,请访问更新日志归档页面。您也可以查阅 Flutter SDK 发布说明

要随时掌握包括破坏性变更在内的 Flutter 公告,请加入 flutter-announce Google 小组。

对于 Dart,您可以加入 Dart Announce Google 小组,并查阅 Dart 更新日志

2026 年 2 月 11 日:“火马年”版本 3.41

#

Flutter 3.41 现已发布!详情请查看 Flutter 3.41 博客文章

3.38 版本发布以来的文档更新或新增内容

除了许多小型更新外,以下是一些更为重要的变更

  • 我们推出了全新的 Flutter 和 Dart 入门体验,正如近期的一篇博客文章中所述。您可以在 docs.flutter.dev 顶部的学习 (Learn) 选项卡下找到 Flutter 学习路径。要返回网站的其他部分,请选择指南 (Guides) 选项卡。一如既往,参考 (Reference) 选项卡会引导您进入 Flutter API 文档

  • Flutter 和 Dart 现已拥有官方词汇表。作为近期将网站迁移至 Jaspr 的一部分,词汇表已被添加到 Flutter 网站中。随着时间的推移,其内容将会不断丰富。

  • 一如既往,请查看此版本的破坏性变更页面,其中包含迁移指南和其他重要信息的链接。特别感谢 navaronbracke,他编写了关于 弃用 onReorder 回调 的迁移指南。


2025 年 11 月 12 日:版本 3.38

#

Flutter 3.38 现已发布!详情请查看 Flutter 3.38 技术博客文章

网站更新

网站近期进行了一次重大更新!与今年早些时候 dart.dev 网站的更新一样,docs.flutter.dev 网站已使用 Dart Web 框架 Jaspr 进行了重构。

请告诉我们您的想法!

3.35 版本发布以来的文档更新或新增内容

  • Dart 语言现在支持点简写 (dot shorthands) 语法(也称为 shorthands),这使您可以编写更简洁的代码。有关更多信息,请访问 dart.dev 上的 Dart 点简写页面。随着时间推移,本网站上的示例将逐步更新以利用此项新特性。

  • flutter run 命令现在支持配置文件,允许您指定主机、端口、证书和 Header 等 Web 设置。Web 开发配置文件还支持代理设置,从而可以将特定的路径请求转发到另一台服务器。这使得开发连接到同一主机上动态端点的 Web 客户端变得更加容易。有关更多信息,请访问设置 Web 开发配置文件

  • Flutter Widget 预览工具(在 3.35 版本中作为实验性功能引入)仍在持续开发中。在此版本中,预览器更好地集成了 VS Code 和 IntelliJ IDE(包括 Android Studio)。这目前仍是一项实验性功能。有关最新版本的更多信息,请查看 Widget 预览工具页面

  • Flutter 3.38 全面支持 9 月发布的 iOS 26、Xcode 26 和 macOS 26 平台版本。有关 Flutter 对 iOS 支持的最新信息,请访问 Flutter 对最新 iOS 的支持

  • Flutter 3.38 支持苹果强制要求的 UIScene 生命周期。为支持此特性,需要进行代码迁移。有关更多信息,请访问 UIScene 迁移指南

  • 为了提升 Flutter 的可访问性,可访问性文档也已完全重写。

  • 此外,别忘了查看此版本的破坏性变更页面。您可以在该页面找到有关破坏性变更、代码弃用和迁移指南的信息。

其他相关资源


2025 年 8 月 13 日:版本 3.35

#

Flutter 3.35 现已发布!有关更多信息,请查看 Flutter 3.35 技术博客文章。您可能还想查看 Dart 3.9 发布博客文章。

3.32 版本发布以来的文档更新或新增内容

  • 热重载 (Hot reload) 现已在 Web 上可用,且不再需要实验性标记。有关更多信息,请查看热重载

  • 新增了 AI 辅助创作指南,涵盖了如何利用 Gemini Code Assist、GeminiCLI 以及 Dart 和 Flutter MCP Server 等 AI 工具,为您的 Flutter 应用构建 AI 驱动的功能。

  • 您现在可以使用 Flutter Widget 预览器指南,在 Chrome 中预览您的 Flutter 组件。

  • 每个稳定版本的发布都会影响 Flutter 支持的部署平台版本。有关更多信息,请访问更新后的支持平台页面。

  • 在 Android 上,您现在可以在共享屏幕时保护敏感内容(例如客户信息)。了解详情,请访问保护您的应用敏感内容

  • 此外,别忘了查看此版本的破坏性变更页面。这也是您查找有用迁移信息的地方。


如需查看过往版本,请访问更新日志归档页面。