重大更改和弃用

本页面列出了 Dart 中所有语言和库的重大更改和弃用，按发行版和区域组织，以帮助 Dart 用户了解和管理它们的影响。完整的发布说明可在 Dart SDK 变更日志 中找到。 重大更改策略 文档描述了 Dart 中重大更改和弃用的策略和流程。

本页面包含以下类型的重大更改：

• 未版本化 : Dart SDK 不维护向后兼容性，如果您依赖于之前的行为，则您的代码在您 升级 SDK 版本 时可能会立即中断。

  这些更改占大多数，在本列表中没有特殊标记。

• 语言版本化 : Dart SDK 维护现有代码的向后兼容性，并且行为更改仅在您升级代码的 语言版本 时才会生效（可能会破坏依赖于先前行为的代码）。

  这些标记为：

• 弃用 : Dart SDK 维护对弃用代码的兼容性，并带有警告。然后在后续版本中完全删除弃用内容，从而破坏任何依赖于先前行为的代码。

  这些标记为： /

• 实验性 : 作为发行版的一部分，但在 SDK 中尚未被视为稳定版本，并且可能在一个版本到另一个版本之间发生中断。实验性更改并不总是具有相应的重大更改问题，但在 SDK 变更日志 中可能会有更多详细信息。

  这些标记为：

如果您对任何这些重大更改有任何疑问或疑虑，请评论相关条目中链接的重大更改问题。要接收有关未来重大更改的通知，请加入 Dart 公告 组。

暂定
以下更改预计将包含在 3.7 稳定版中，但在那之前最终列表可能会更改。为了减少这些更改的潜在影响，请考虑在 3.7 版本发布之前考虑它们。

• 名为 _ 的局部变量和参数 现在是非绑定的，不能再使用或访问。
• 可达性分析现在考虑使用 is 或 as 将字段类型提升为 Null 的情况 。这使得类型系统更加自洽，因为它反映了提升的局部变量的行为。此更改预计不会在实践中产生任何差异。

• package_api_docs 和 unsafe_html lint 规则已被删除，应从 analysis_options.yaml 文件中删除。

• 格式化程序实现了一种 新样式 ，当使用 3.7 或更高版本的 语言版本 格式化代码时，会产生新的输出。
• dart format 的 --fix 标志不再受支持。要应用类似的修复和其他修复，请 配置您的分析选项 并运行 dart fix 。
• dart format 的 --line-length 选项已被弃用，并将被删除。所有用法都应迁移到新的 --page-width 选项。

• Dart 用于对 throw 表达式的操作数执行类型推断的上下文已从“未知类型”更改为 Object 。这使得类型系统更加自洽，因为它反映了抛出 null 是非法的这一事实。此更改预计不会在实践中产生任何差异。

• 已删除 Platform() 构造函数 。所有 Platform 的实例化都应删除。
• HttpClient 现在通过 抛出 RedirectException 而不是 StateError 来响应缺少“Location”标头的重定向。

• package_api_docs 和 unsafe_html lint 规则已被弃用，并将在 Dart 3.7 中删除。

• Dart 编译器现在 在类型模式传递到子类型测试过程之前计算类型模式的上限和下限闭包 。在 Dart 3.6 之前，编译器在上限和下限计算的开始就计算它们。分析器已经遵循了这种行为，因此已经通过分析的应用程序不太可能受到此更改的影响。

• 编译到 WebAssembly 时，条件导入中的条件 dart.library.js 现在为 false 。应改用 dart.library.js_interop 条件。

使用 Dart 3.6 SDK 或更高版本运行 dart format 时，以下更改可能会导致小的格式更改：

• 保留旧样式函数类型形式参数上的类型参数，这些参数也使用 this. 或 super. 。
• 正确格式化同时具有 as 和 if 子句的导入。

• dart pub publish 现在会在 git 中跟踪的文件具有未提交的更改时发出警告。

• 编译器用于对 await 表达式的操作数执行类型推断的上下文已更改为与分析器的行为匹配。
• 编译器用于对“if-null”表达式 (e1 ?? e2) 的右侧执行类型推断的上下文已更改为与分析器的行为匹配。 通过提供显式类型可以恢复旧行为。

• DateTime 现在在 Web 平台上存储微秒 ，更接近于原生平台上的行为。

• SecurityContext 现在是 final 的，不能再进行子类化 。

• importModule 现在接受 JSAny 而不是 String ，以支持其他 JS 值，例如 TrustedScriptURL 对象。
• isTruthy 和 not 现在返回 JSBoolean 而不是 bool ，以与其他 JS 运算符方法保持一致。
• ExternalDartReference 不再实现 Object 。相反，它现在接受一个类型参数 (T)，其边界为 Object? ，以捕获外部化的 Dart 对象的类型。

• 已删除类型数据的不可修改视图类 。不要使用这些类的构造函数，而应在类型数据列表上使用新的 asUnmodifiableView 方法。

• Dart VM 不再支持不健全的空安全。
• 已删除 --no-sound-null-safety CLI 选项。
• 已从 C API 中删除 Dart_NewListOf 和 Dart_IsLegacyType 函数。
• 已从 C API 中删除 Dart_DefaultCanonicalizeUrl 函数。

• 强制模式的模式上下文类型模式现在为 _ （未知类型）而不是 Object? 。
• Dart 编译器用于对映射和集合文字中的空感知扩展运算符 (...?) 的操作数执行类型推断的类型模式已变为可空 ，以匹配当前在列表文字中发生的情况。

• 已删除 waitFor 函数 。

• 这些库现在被标记为旧版，将来将获得较少的支持。新项目应该更喜欢使用 package:web 和 dart:js_interop 。要了解更多信息，请查看 迁移到 package:web 。

• 此库现在被标记为旧版，将来将获得较少的支持。用法应迁移到 dart:js_interop 和 dart:js_interop_unsafe 。要了解更多信息，请查看 /go/next-gen-js-interop 。

• 此库现在被标记为旧版，将来将获得较少的支持。用法应迁移到 dart:js_interop 和 dart:js_interop_unsafe 。要了解更多信息，请查看 /go/next-gen-js-interop 。

• [Stdout 有一个新的字段 lineTerminator ，它允许

允许开发人员控制 stdout 和 stderr 使用的行尾。](https://github.com/dart-lang/sdk/issues/53863) 实现 Stdout 的类必须定义 lineTerminator 字段。 stdout 和 stderr 的默认语义没有更改。

• FileSystemDeleteEvent.isDirectory 属性。它始终返回 false 。

• 类型数据的不可修改视图类已弃用 。不要使用这些类的构造函数，而应在类型数据列表上使用新的 asUnmodifiableView 方法。

• 您现在应该为 --dump-info CLI 选项指定 binary 或 json 格式。 json 格式已弃用，并可能在未来的 Dart 版本中删除。

• 各种 dart compile wasm CLI 参数已被更新、删除或替换。要了解更多信息，请运行 dart compile wasm --verbose --help 。

• Dart VM 不再支持外部字符串。因此， Dart_IsExternalString 、 Dart_NewExternalLatin1String 和 Dart_NewExternalUTF16String 函数已从 Dart C API 中删除。

• 以下实验现已停用，因为它们已在 Dart 3 中发布，并且使用 3.0 或更高版本的语言版本不再需要。应从分析选项、CLI 命令和 IDE 配置中删除它们的配置。

• patterns

• records

• class-modifers

• sealed-class

• 如果没有任何冲突的声明，则现在认为抽象 getter 是可提升的 。

• waitFor 函数 在另一个版本中仍然被弃用，并将在 Dart 3.4 中删除。

• Pointer 类型上的 elementAt 指针算术方法已弃用 。改为迁移到 - 和 + 运算符。
• 先前已弃用的 @FfiNative 注解已被删除。用法应更新为使用 @Native 注解。

• 现在建议使用 package:http ，而不是直接使用 HttpRequest 。

• 现在建议使用 package:http ，而不是直接使用 HttpClient 。

• 像 JSAny 这样的 JS 类型具有 新的编译器特定表示类型 。
• 用户定义的 @staticInterop 类 不能再实现 JSAny 或 JSObject 。用法应迁移到 JSObject.fromInteropObject 或定义为扩展类型。
• JSArray 和 JSPromise 现在具有泛型参数。
• 各种扩展成员已被移动或重命名。要了解更新的扩展，请参考 JSAnyUtilityExtension 和 JSAnyOperatorExtension 。

• 类型数据的不可修改视图类将在 Dart 3.4 中被弃用 。不要使用这些类的构造函数，而应在类型数据列表上使用新的 asUnmodifiableView 方法。

• 所有原生包装器类现在都被标记为 base ，因此它们的任何子类型都不能被实现。

• 传递给 noSuchMethod 的 Invocation 不再具有缩小的 memberName ，即使使用 --minify 编译也是如此。

• 不允许导入旧版 JS 交互操作库 。最好使用 dart:js_interop 和 dart:js_interop_unsafe 。

• 分析器现在报告无效的 dart doc 注释指令。

• 由于 类型提升方面的改进 ，以下分析器诊断可能会在先前通过分析的现有代码上触发：

  • unnecessary_non_null_assertion
  • unnecessary_cast
  • invalid_null_aware_operator

• iterable_contains_unrelated_type 和 list_remove_unrelated_type lint 检查已被删除。考虑迁移到扩展的 collection_methods_unrelated_type lint 检查。

• 由于在健全的空安全下不再需要，以下 lint 检查已被删除。您应该从您的 analysis_options.yaml 文件和任何忽略注释中删除它们的配置。

  • always_require_non_null_named_parameters
  • avoid_returning_null
  • avoid_returning_null_for_future

• 更改了可反驳模式的分割点 到顶级模式，以便无论被检查对象是否可能抛出异常，if-case 语句中的类型提升都是一致的。

• waitFor 函数 。

• 更改了 utf8.encode() 和 Utf8Codec.encode() 的返回类型 从 List<int> 到 Uint8List 。

• Service.getIsolateID 方法。

• 更改了 NativeCallable.nativeFunction ，以便如果接收器已关闭，调用现在会抛出错误 ，而不是返回 nullptr 。

• 消除了 HTTP 标头中的尾随空格 。
• 在折叠的标头值的折叠点插入了一个空格 HttpClientResponse.headers 和 HttpRequest.headers 返回。

• JSNumber.toDart ，改为使用 toDartDouble 和 toDartInt 。
• Object.toJS ，改为使用 Object.toJSBox. 。
• 将使用 dart:js_interop 的外部 JS 交互操作 API 限制为一组允许的类型。
• 禁止在 dart2wasm 上使用 isNull 和 isUndefined 。
• 将 typeofEquals 和 instanceof API 都更改为返回 bool 而不是 JSBoolean 。此外， typeofEquals 现在采用 String 而不是 JSString 。
• 将 JSAny 和 JSObject 类型更改为仅可由用户 @staticInterop 类型实现，而不是扩展。
• 将 JSArray.withLength 更改为采用 int 而不是 JSNumber 。

• 为 JavaScript Symbol 和 BigInt 类型添加了拦截器 ；它们不应再与 package:js 类一起使用。

• 为 JavaScript Symbol 和 BigInt 类型添加了拦截器 ；它们不应再与 package:js 类一起使用。

• 私有 final 字段提升 可能会导致以下分析器警告在先前通过分析的现有代码上触发：

• unnecessary_non_null_assertion

• invalid_null_aware_operator

• unnecessary_cast

class C {
  final num? _x = null;

  void test() {
    if (_x != null) {
      print(_x! * 2); // unnecessary_non_null_assertion
      print(_x?.abs()); // invalid_null_aware_operator
    }
    if (_x is int) {
      print((_x as int).bitLength); // unnecessary_cast
    }
  }
}

• 为纯抽象类添加了 interface 修饰符： MultiStreamController 、 StreamConsumer 、 StreamIterator 和 StreamTransformer 。

• 向 Cookie 类添加了 sameSite ，并添加了类 SameSite 。
• FileSystemEvent 是 sealed 。这意味着 FileSystemEvent 不能被扩展或实现。

• ObjectLiteral ；使用 {} .jsify() 创建没有命名成员的对象文字。

• external @staticInterop 成员和 external 扩展成员不能再用作撕裂器。声明一个闭包或一个非 external 方法来调用这些成员，并改用它。
• external @staticInterop 成员和 external 扩展成员将为具有可选参数的方法生成略微不同的 JS 代码。

• 更改了[switch 语句分支]的解释，从常量表达式更改为模式。

• 已升级到 Dart 3.0 的库中的类声明 默认情况下不能再用作 mixin 。

• 如果 continue 语句的目标是[标签]，而不是循环（ for 、 do 和 while 语句）或 switch 成员，则 Dart 会报告编译时错误 。

• 以下现有类已成为 mixin 类： Iterable 、 IterableMixin 、 IterableBase 、 ListMixin 、 SetMixin 、 MapMixin 、 LinkedListEntry 、 StringConversionSink 。

• 已弃用的 API 。

• 已删除已弃用的 DeferredLibrary 类。

• 对平台库的更改 。

• 已删除已弃用的 MAX_USER_TAGS 常量。改为使用 maxUserTags 。
• 已删除已弃用的 Metrics 、 Metric 、 Counter 和 Gauge 类，因为自 Dart 2.0 以来它们已损坏。

• @FfiNative 注解现已弃用。用法应更新为使用 @Native 注解。

• 已删除 Document 和 HtmlDocument 中已弃用的 registerElement 和 registerElement2 方法。

• Random 接口只能实现，不能扩展。

• 更新了 NetworkProfiling ，以适应在 vm_service:11.0.0 中引入的新 String ID。

• 由于类型 Null 和 Never ， 将其他代码标记为不可达 。
• 不要将不可访问的私有名称委托给 noSuchMethod 。
• 在顶级类型推断期间， 对所有循环依赖项报告编译时错误 。

• 已删除先前已弃用的 API JsonUtf8Encoder 中的[DEFAULT_BUFFER_SIZE]。

• 已删除先前已弃用的 API ServiceExtensionResponse中的 kInvalidParams 、 kExtensionError 、 kExtensionErrorMax 和 kExtensionErrorMin 。

• 将 Pointer 的运行时类型参数更改为 Never ，准备完全删除运行时类型参数。更改了 Pointer.toString ，使其不报告任何类型参数。

• 不允许使用负数或十六进制内容长度标头 。
• File.create 现在采用新的可选 exclusive bool 参数 ，当它为 true 时，如果目标文件已存在，则操作将失败。
• 多次调用 ResourceHandle.toFile() 、 ResourceHandle.toSocket() 、 ResourceHandle.toRawSocket() 或 ResourceHandle.toRawDatagramSocket() 现在会抛出 StateError 。

• 在发送不在已知共享相同代码的隔离区之间的消息时，将 SendPort.send 还原为对消息内容的严格检查。

• 已删除 API MirrorsUsed 和 Comment 。

• 对预览功能 @staticInterop 的重大更改：
  • 禁止使用此注释的类使用 external 生成式构造函数。有关更多详细信息，请参阅48730和49941。
  • 禁止使用此注释的外部扩展成员使用类型参数 。
  • 使用此注释的类也应具有 @JS 注释。
  • 没有此注释的类不能实现使用此注释的类。

• dart2js 不再支持 HTTP URI 作为输入 。

• 删除了对不扩展 Object 的类的 mixin 支持 。

• 将 dart:io 中 RedirectException 的 uri 属性更改为可空 。
• 删除了遵循 SCREAMING_CAPS 约定的 dart:io 网络 API 中的常量 。
• Dart VM 不再在退出时自动恢复初始终端设置 。

• 完全弃用了 .packages 文件 。

• 删除了独立的 dart2js 和 dartdevc 工具 。
• 删除了独立的 dartanalyzer 工具 。

• 向 HttpClient 添加了新的 connectionFactory 属性 。
• 向 HttpClient 添加了新的 keyLog 属性 ，允许记录 TLS 密钥以进行调试。
• 删除了遵循 SCREAMING_CAPS 的 dart:io 常量
• 向 SecurityContext 添加了新的 allowLegacyUnsafeRenegotiation 属性 ，允许客户端安全套接字进行 TLS 重新协商。

• 已弃用独立的 dart2js 工具 。
• 已弃用独立的 dartdevc 工具 。
• 已删除独立的 dartdoc 工具 。

• 在 Windows 上，如果 newPath 指定了一个，则 Directory.rename 将不再删除目录 。相反，将抛出 FileSystemException 。
• 已删除 Platform.packageRoot API 。

• 已删除 Isolate.packageRoot API 。

• 已弃用独立的 dartanalyzer 工具 。
• 已弃用独立的 dartdoc 工具 。
• 已删除已弃用的独立 pub 工具 。

• 更新了 SecurityContext 类 ，将最小 TLS 协议版本设置为 TLS1_2_VERSION (1.2)，而不是 TLS1_VERSION。

• 已完全删除 dart:web_sql 库 。

• 已删除 window.openDatabase （与上面 dart:web_sql 的删除相关）。

• 已删除独立的 dart2native 工具 。
• 已删除独立的 dartfmt 工具。

• 已删除对 dart-ext: 样式原生扩展的支持
• 将通过 Isolate.spawn() API 生成的隔离区分组 以在相同的托管堆上运行，因此共享各种 VM 内部数据结构。

• HttpClient 中的 setter 回调 .authenticate 和 .authenticateProxy 现在必须接受一个可为空的 realm 参数（用于迁移前的空安全代码）。

• 此库公开的大多数类型 不能再扩展、实现或混合 。

• Expandos 和 Dart_NewWeakPersistentHandle 和 Dart_NewFinalizableHandle 的 object 参数 不再接受 Pointer 和 Struct 的子类型

• 已弃用独立的 dart2native 工具
• 已弃用独立的 dartfmt 工具。

• dart2js 不再支持旧版浏览器 ，因为它默认情况下会发出 ES6+ JavaScript。

• 更改了 package:js 类的子类型关系 ，使其更正确，并与 Dart2JS 保持一致。

• 不再有效 在非匿名 JS 交互操作类的 @JS() 注释中使用与 @Native 注释匹配的 String 。

• 在所有尚未选择退出的代码中，空安全现在默认启用。
• 修复了一个实现错误 ，其中 this 有时会在扩展中进行类型提升。

• 已弃用使用泛型 T 的调用 sizeOf<T> 、 Pointer<T>.elementAt() 、 Pointer<T extends Struct>.ref 和 Pointer<T extends Struct>[] 。
• 已弃用 package:ffi 中的 allocate ，因为它将不再能够泛型地调用 sizeOf<T> 。
• 已弃用没有任何原生成员的 Struct 的子类型 。

• 当引用的对象被垃圾收集时， Dart_WeakPersistentHandle 不再自动删除自身 ，以避免竞争条件。
• 将 Dart_WeakPersistentHandleFinalizer 重命名为 Dart_HandleFinalizer ，并删除了其 handle 参数。

• pubspec.yaml 中现在 需要 Dart SDK 约束 。

• 将 dart_api_dl.cc 重命名为 dart_api_dl.c 并更改为纯 C 文件。

• 在将包含不成对的代理字符的字符串编码为 UTF-8 时， 不成对的代理字符将被编码为替换字符 （ U+FFFD ）。
• 在解码 UTF-8 时， 编码的代理字符将被视为格式错误的输入 。
• 更改了为格式错误的输入序列发出的替换字符数量 ，使其与WHATWG 编码标准匹配，当使用 allowMalformed: true 解码 UTF-8 时。

• 如果 CssClassSet 对应于多个元素，则 CssClassSet.add() 和 CssClassSet.toggle 现在返回 false 而不是 null 。

• 如果导入了 dart:mirrors ，Web 编译器（dart2js 和 DDC）现在会产生编译时错误 。

• 使用 print 函数打印字符串时， 默认实现会将字符串中的任何不成对的代理字符打印为替换字符 （ U+FFFD ）。
• Dart API 中的 Dart_StringToUTF8 函数 会将不成对的代理字符转换为替换字符 。

• 修复了一个实现错误 ，其中局部变量推断会错误地使用类型变量的提升类型。
• [修复了一个实现错误](https://github.com/dart-lang/sdk/issues/41362），围绕子句 implements Function 、 extends Function 或 with Function 自 Dart 2.0.0 以来不再有效。

• 将 StreamSubscription.cancel() 的返回类型更改为 Future<void> 。
• 将 runZoned() 函数拆分为两个函数 ： runZoned() 和 runZonedGuarded() ，后者具有必需的 onError 参数，而前者没有。
• 传递给 Completer.completeError() 、 Stream.addError() 、 Future.error() 等的错误 不能再为 null 。
• 使堆栈跟踪不可为空 。

• RuneIterator 上的三个成员 在第一次调用 moveNext() 之前访问时不再返回 null 。
• String.fromEnvironment() 的 defaultValue 的默认值 现在是空字符串而不是 null 。
• int.fromEnvironment() 的 defaultValue 参数的默认值 现在为零 。

• 将 Pointer.asFunction() 和 DynamicLibrary.lookupFunction() 更改为扩展方法。

• 更改了 HttpHeaders 方法 add() 和 set 的签名。
• 如果套接字已被显式销毁或在设置或获取套接字选项时升级到安全套接字，则 Socket 类现在会抛出 SocketException 。
• 如果进程已分离（ ProcessStartMode.detached 和 ProcessStartMode.detachedWithStdio ），则 Process 类现在会抛出 StateError ，访问 exitCode getter 时。
• 如果未连接到子进程的 stdio（ ProcessStartMode.detached 和 ProcessStartMode.inheritStdio ），则 Process 类现在也会抛出 ，访问 stdin 、 stdout 和 stderr getter 时。
• 如果 FileStat.stat() 或 FileStat.statSync() 失败，则返回的虚拟对象 现在包含 Unix 时间戳 ，而不是 accessed 、 changed 和 modified getter 的 null 。
• HeaderValue 类现在在两个无效的边缘情况下进行更严格的解析 。

我们修复了 DDC 和 Dart2JS 之间的几个不一致之处，以便用户较少遇到一个编译器接受但另一个编译器失败的代码。

• 删除了 DDC 的旧版（基于分析器）版本。
• 现在必须使用对 allowInterop 的调用来包装传递到 JavaScript 的函数，这些函数使用推荐的 package:js 交互操作规范。
• @JS() 类中的构造函数必须标记为 external 。

• 现在，相应的类型参数边界只需要是相互的子类型，而不是在重命名绑定类型变量并将所有顶级类型等同起来的情况下在结构上相等。
• 类型现在已标准化。
• @JS() 类中的构造函数必须标记为 external 。
• 完全删除了 --package-root 标志，该标志在 Dart 2.0.0 中被隐藏和禁用。

• macOS 的 Dart SDK 现在仅适用于 x64 。

• 使用前缀导入时，可以访问静态扩展成员 。

• 添加了 IOOverrides.serverSocketBind ，以帮助编写想要模拟 ServerSocket.bind 的测试。

• 更改了在 FutureOr 上下文中使用 Null 值时的推断 。也就是说，类似于 Null <: FutureOr<T> 的约束现在会产生 Null 作为 T 的解决方案。

• API 现在使用静态扩展成员。
• 删除了内存管理 Pointer.allocate 和 Pointer.free 。
• Pointer.offsetBy 已删除，改为使用 cast 和 elementAt 。

• 各种核心库中的各种方法和属性，以前声明的返回类型为 List<int> ，已 更新为声明返回类型为 Uint8List 。

• Cookie 类的构造函数的 name 和 value 可选位置参数 现在是必需的 。
• Cookie 类的 name 和 value setter 现在会验证 字符串是否由允许的字符集组成并且不为 null。

• 发布到 pub.dev 的包 不能再包含 git 依赖项 。

• 现在强制执行在超接口中使用的类型变量的协变 。

• 使用 dart2js 或 DDC 编译时， Isolate.resolvePackageUri 将始终抛出 UnsupportedError 。

• 修复了 StreamIterator 类中的一个错误 ，其中 await for 允许 null 作为流。

• Kernel AST API 中 InstanceConstant 类的 klass getter 已重命名为 classNode 以保持一致性。
• 更新了 Link 实现 ，以便在 Windows 上使用真正的符号链接而不是连接点。

• 现在向已关闭的 IOSink 添加内容会抛出 StateError 。

• 修复了使用 dart:mirrors 时的一个健全性漏洞 ，该漏洞以违反其静态类型的不正确方式反射地调用方法。

• 许多应该被检测并报告的静态错误在 2.0.0 中不受支持。这些错误现在已报告，这意味着现有不正确的代码可能会显示新的错误：
  • Mixin 必须正确覆盖其超类 。
  • extends 子句中的隐式类型参数必须满足类边界 。
  • 实例成员应隐藏前缀 。
  • 构造函数调用必须使用有效的语法，即使使用可选的 new 。
  • 泛型类型定义的类型参数必须满足其边界 。
  • 类不能实现 FutureOr 。
  • 抽象方法不能以不合理的方式覆盖具体方法 。
  • 常量构造函数不能重定向到非常量构造函数 。
  • 名称与封闭类相同的 setter 不允许 。

• 不允许在 const map 中使用重复的键，并会产生编译时错误。

• 使用类型推断和运行时检查替换了不健全的可选静态类型系统，以前称为强模式。
• [标记为 async 的函数现在同步运行](https://github.com/dart-lang/sdk/issues/30345），直到第一个 await 语句。

• 将核心库中的常量名称从 SCREAMING_CAPS 重命名为 lowerCamelCase 。
• 向核心库类添加了许多新方法，如果您实现这些类的接口，则需要实现这些方法。
• 使用 Dart 编写 Web 应用时，不再支持 dart:isolate 和 dart:mirrors 。

• 使用 新的构建系统 替换了 pub 基于转换器的构建系统。

除非另有说明，否则本网站上的文档反映的是 Dart 3.6.0。页面最后更新于 2025-02-05。 查看源代码 或 报告问题.