重大更改和弃用

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

此页面包括以下类型的重大更改:

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

  这些是大多数更改，在此列表中未特别标记。

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

  这些标记为： 语言版本化

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

  这些标记为： 已弃用 / 已删除

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

  这些标记为：实验性

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

暂定
以下更改预计将包含在 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 子句的导入。

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

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

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

• SecurityContext 现在是 final 的，不能再被子类化.

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

• 已移除 用于类型化数据的不可修改视图类已被移除。请勿使用这些类的构造函数，而应使用类型化数据列表上的新的 asUnmodifiableView 方法。

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

• 强制转换模式的模式上下文类型架构现在是 _ (未知类型)，而不是 Object?。.
• Dart 编译器用于对 map 和 set 字面量中可空传播运算符 (...?) 的操作数执行类型推断的类型架构已设置为可为空，以匹配列表字面量中当前发生的情况。

• 实验性 已移除 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 使用的行尾符。实现 Stdout 的类必须定义 lineTerminator 字段。stdout 和 stderr 的默认语义没有改变。
• 已弃用 FileSystemDeleteEvent.isDirectory 属性。它始终返回 false。

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

• 实验性 已弃用 您现在应该为 --dump-info 命令行选项指定 binary 或 json 格式。json 格式已弃用，可能会在未来的 Dart 版本中删除。

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

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

• 实验性 已移除 以下实验现已停用，因为它们已在 Dart 3 中发布，并且在语言版本为 3.0 或更高版本时不再需要。应从分析选项、命令行和 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 返回的折叠标头值的折叠点插入一个空格。

• 实验性 已移除 使用 toDartDouble 和 toDartInt 代替 JSNumber.toDart。
• 实验性 已移除 使用 Object.toJSBox 代替 Object.toJS。
• 实验性 使用 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
  dart

  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 扩展成员不再可以用作 tear-offs。请声明一个闭包或一个调用这些成员的非 external 方法，并改用该方法。
• external @staticInterop 成员和 external 扩展成员将为具有可选参数的方法生成略有不同的 JS 代码。

• 语言版本化 将 switch case 的解释从常量表达式更改为模式。

• 语言版本化 从已升级到 Dart 3.0 的库中的类声明，默认情况下不再能用作 mixins。

• 如果 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.
• 在顶级类型推断期间，对所有循环依赖项报告编译时错误。

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

• 已移除 移除了先前已弃用的 API kInvalidParams、kExtensionError、kExtensionErrorMax 和 kExtensionErrorMin，这些 API 位于 ServiceExtensionResponse 中。

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

• 不允许负数或十六进制 content-length 标头.
• 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 的类进行混入的支持.

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

• 完全停止使用 .packages 文件.

• 移除了独立的 dart2js 和 dartdevc 工具.
• 移除了独立的 dartanalyzer 工具.

• 向 HttpClient 添加了新的 connectionFactory 属性.
• 向 HttpClient 添加了新的 keyLog 属性，该属性允许记录 TLS 密钥以用于调试目的。
• 删除了 dart:io 中遵循 SCREAMING_CAPS 的常量
• 向 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 现在必须接受可为 null 的 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 函数会将不成对的代理项转换为替换字符。

• 修复了一个实现错误，该错误会导致局部变量推断错误地使用类型变量的提升类型。
• 修复了一个实现错误，该错误导致 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。
• 将堆栈跟踪设为非 null.

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

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

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

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

• 删除了旧的（基于分析器的）DDC 版本。
• 现在，使用推荐的 package:js 互操作规范传递给 JavaScript 的函数必须用 allowInterop 调用包装。
• @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 中不支持许多应该被检测和报告的静态错误。 现在报告这些错误，这意味着现有的不正确代码可能会显示新的错误
  • 混入必须正确覆盖其超类.
  • extends 子句中的隐式类型参数必须满足类边界.
  • 实例成员应隐藏前缀.
  • 构造函数调用必须使用有效的语法，即使带有可选的 new.
  • 泛型 typedef 的类型参数必须满足其边界.
  • 类不能实现 FutureOr.
  • 抽象方法可能不会不健全地覆盖具体方法.
  • 常量构造函数不能重定向到非常量构造函数.
  • 不允许使用与封闭类名称相同的 setter.

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

• 使用类型推断和运行时检查，用健全的静态类型系统替换了不健全的可选静态类型系统，以前称为强模式。
• 标记为 async 的函数现在会同步运行，直到第一个 await 语句。

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

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

除非另有说明，否则本网站上的文档反映了 Dart 3.6.0。 页面最后更新于 2024-12-10。 查看源 或 报告问题。