重大變更與棄用

本頁列出 Dart SDK 中所有的重大變更與棄用，依發布版本和區域分類，以協助 Dart 使用者瞭解並管理其影響。完整的發布版本注意事項可在Dart SDK 變更日誌中取得。重大變更政策文件說明了 Dart 中重大變更與棄用的政策與流程。

本頁包含以下類型的重大變更:

• 未版本化：Dart SDK 不維護向後相容性，如果您依賴先前的行為，程式碼可能會在您升級 SDK 版本後立即中斷。

  這些是大多數的變更，且未在此列表中特別標記。

• 語言版本化：Dart SDK 維護現有程式碼的向後相容性，行為變更只會在您升級程式碼的語言版本時生效 (可能會中斷依賴先前行為的程式碼)。

  這些標記為： 語言版本化

• 棄用：Dart SDK 維護已棄用程式碼的相容性，並發出警告。棄用會在後續版本中完全移除，中斷任何依賴先前行為的程式碼。

  這些標記為： 已棄用 / 已移除

• 實驗性：屬於發布版本的一部分，但在 SDK 中尚未被視為穩定，且可能會在版本之間中斷。實驗性變更不一定會有對應的重大變更問題，但可能在SDK 變更日誌中有更多詳細資訊。

  這些標記為：實驗性

如果您對任何這些重大變更有疑問或疑慮，請在相關條目的重大變更問題連結中留言。若要收到未來重大變更的通知，請加入 Dart announce 群組。

• 語言版本化 名為 _ 的區域變數和參數現在為非綁定，且無法再使用或存取。
• 可達性分析現在會考量欄位是否使用 is 或 as 類型提升為 Null。這使類型系統更自我一致，因為它反映類型提升的區域變數的行為。此變更預期不會在實務上造成任何差異。

• 已棄用 這些舊版 Web 函式庫已正式棄用。預計在未來版本中移除。專案應遷移至使用 package:web 和 dart:js_interop。若要瞭解詳情，請查看遷移至 package:web。

• 已棄用 這些舊版 JS 互通函式庫已正式棄用。預計在未來版本中移除。專案應遷移至使用 dart:js_interop。若要瞭解詳情，請查看JS 互通性用法。

• 已移除 package_api_docs 和 unsafe_html linter 規則已移除，應從 analysis_options.yaml 檔案中移除。

• 語言版本化 格式化工具實作了新的風格，當使用語言版本 3.7 或更高版本格式化程式碼時，會產生新的輸出。
• 已移除 dart format 的 --fix 標記已不再支援。若要套用類似的修正及更多功能，請設定您的分析選項並執行 dart fix。
• 已棄用 dart format 的 --line-length 選項已棄用，並設定為移除。所有用法都應遷移至新的 --page-width 選項。

• Dart 用於對 throw 表達式的運算元執行類型推論的上下文已從「未知類型」變更為 Object。這使類型系統更自我一致，因為它反映擲回 null 是不合法的。此變更預期不會在實務上造成任何差異。

• 已移除 Platform() 建構子已移除。應移除 Platform 的所有實例化。
• HttpClient 現在會回應缺少「Location」標頭的重新導向，方法是擲回 RedirectException 而非 StateError。

• 已棄用 package_api_docs 和 unsafe_html linter 規則已棄用，並設定在 Dart 3.7 中移除。

• Dart 編譯器現在在類型綱要傳遞至子類型測試程序之前，立即計算其上限和下限閉包。在 Dart 3.6 之前，編譯器會在上限和下限計算的最開始計算它們。分析器已遵循此行為，因此已通過分析的應用程式不太可能受到此變更的影響。

• 條件 dart.library.js 在編譯為 WebAssembly 時，在條件式匯入上現在為 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。相反地，它現在接受類型參數 (T)，其界限為 Object?，以捕捉外部化的 Dart 物件的類型。

• 已移除 typed data 的不可修改檢視類別已移除。請勿使用這些類別的建構子，改為使用 typed data list 上的新 asUnmodifiableView 方法。

• 已移除 Dart VM 不再支援不健全的 Null 安全性。
  • --no-sound-null-safety CLI 選項已移除。
  • Dart_NewListOf 和 Dart_IsLegacyType 函式已從 C API 移除。
• 已移除 Dart_DefaultCanonicalizeUrl 函式已從 C API 移除。

• cast 模式的模式上下文類型綱要現在為 _ (未知類型) 而非 Object?.
• Dart 編譯器用於對 map 和 set 常值中的 null 感知擴展運算子 (...?) 的運算元執行類型推論的類型綱要已設為可為 null，以符合目前在 list 常值中發生的情況。

• 實驗性 已移除 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。

• 已棄用 typed data 的不可修改檢視類別已棄用。請勿使用這些類別的建構子，改為使用 typed data list 上的新 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。

• 實驗性 JS 類型 (例如 JSAny) 具有新的編譯器特定表示類型。
• 實驗性 使用者定義的 @staticInterop 類別無法再實作 JSAny 或 JSObject。用法應遷移至 JSObject.fromInteropObject 或定義為擴充類型。
• 實驗性 JSArray 和 JSPromise 現在具有泛型參數。
• 實驗性 各種擴充成員已移動或重新命名。若要瞭解更新的擴充功能，請參考 JSAnyUtilityExtension 和 JSAnyOperatorExtension。

• typed data 的不可修改檢視類別將在 Dart 3.4 中棄用。請勿使用這些類別的建構子，改為使用 typed data list 上的新 asUnmodifiableView 方法。

• 實驗性 所有原生包裝函式類別現在都標記為 base，因此它們的子類型都無法實作。

• 即使使用 --minify 編譯，傳遞至 noSuchMethod 的 Invocation 也不再具有精簡的 memberName。

• 實驗性 不允許匯入舊版 JS 互通函式庫。請改為偏好使用 dart:js_interop 和 dart:js_interop_unsafe。

• 實驗性 無效的 dart doc 註解指令現在由分析器回報。

• 由於 類型提升的改進，以下分析器診斷訊息可能會在先前通過分析的現有程式碼上觸發

  • unnecessary_non_null_assertion (不必要的非空斷言)
  • unnecessary_cast (不必要的轉型)
  • invalid_null_aware_operator (無效的 null 感知運算子)

• iterable_contains_unrelated_type 和 list_remove_unrelated_type linter 已移除。請考慮遷移至擴充的 collection_methods_unrelated_type linter。

• 由於健全的 Null 安全性不再需要，因此以下 linter 已移除。您應從您的 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 (無效的 null 感知運算子)
  • unnecessary_cast (不必要的轉型)
  dart (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。

• 將 sameSite 新增至 Cookie 類別，並新增類別 SameSite.
• FileSystemEvent 為 sealed。這表示 FileSystemEvent 無法擴充或實作。

• 實驗性 已移除 ObjectLiteral；使用 {}.jsify() 建立沒有具名成員的物件常值。

• external @staticInterop 成員和 external 擴充成員無法再用作 tear-off。宣告一個閉包或呼叫這些成員的非 external 方法，並改用該方法。
• external @staticInterop 成員和 external 擴充成員將為具有選用參數的方法產生稍微不同的 JS 程式碼。

• 語言版本化 將switch cases 的解譯從常數表達式變更為模式。

• 語言版本化 從已升級至 Dart 3.0 的函式庫中的類別宣告預設無法再用作 mixin。

• 如果 continue 語句目標為非迴圈 (for、do 和 while 語句) 或 switch 成員的 label，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 ServiceExtensionResponse 中的 kInvalidParams、kExtensionError、kExtensionErrorMax 和 kExtensionErrorMin。

• 變更了 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 generative 建構子。如需更多詳細資訊，請參閱 48730 和 49941。
  • 不允許具有此註解的類別的外部擴充成員使用類型參數.
  • 具有此註解的類別也應具有 @JS 註解。
  • 具有此註解的類別不能由沒有此註解的類別實作。

• dart2js 不再支援 HTTP URI 作為輸入.

• 移除了對不擴充 Object 的類別的 mixin 支援.

• 將 dart:io 中 RedirectException 的 uri 屬性變更為可為 null.
• 移除了 dart:io 網路 API 中遵循 SCREAMING_CAPS 慣例的常數.
• Dart VM 不再在結束時自動還原初始終端機設定。

• 完全終止了 .packages 檔案.

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

• 新增了新的 connectionFactory 屬性至 HttpClient.
• 新增了新的 keyLog 屬性至 HttpClient，可讓記錄 TLS 金鑰以進行除錯。
• 移除了 dart:io 中遵循 SCREAMING_CAPS 的常數
• 新增了新的 allowLegacyUnsafeRenegotiation 屬性至 SecurityContext，可讓用戶端安全 Socket 進行 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 產生的 isolates，使其在相同的受管理堆積上運作，並因此共享各種 VM 內部資料結構。

• HttpClient 中的 setter 回呼 .authenticate 和 .authenticateProxy 現在必須接受可為 null 的 realm 引數（適用於預先遷移的 Null 安全程式碼）。

• 此程式庫公開的大多數類型 不再能被擴充、實作或混入。

• Expandos，以及 Dart_NewWeakPersistentHandle 和 Dart_NewFinalizableHandle 的 object 參數，不再接受 Pointer 和 Struct 的子類型

• 已棄用獨立的 dart2native 工具
• 已棄用獨立的 dartfmt 工具。

• dart2js 不再支援舊版瀏覽器，因為預設情況下它會發出 ES6+ JavaScript。

• 變更 package:js 類別的子類型關係，使其更正確且與 Dart2JS 一致。

• 在非匿名 JS 互通類別的 @JS() 註解中，使用與 @Native 註解匹配的 String 已不再有效。

• Null 安全性 現在已在所有未選擇退出的程式碼中預設啟用。
• 修正了一個實作錯誤，其中 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 時，編碼的代理字元將被視為格式錯誤的輸入。
• 變更了針對格式錯誤的輸入序列發出的替換字元數量，以在使用 allowMalformed: true 解碼 UTF-8 時符合 WHATWG 編碼標準。

• 如果 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 已被明確銷毀或升級為安全 socket，則 Socket 類別現在會在設定或取得 socket 選項時拋出 SocketException。
• 如果進程已分離 (ProcessStartMode.detached 和 ProcessStartMode.detachedWithStdio)，則 Process 類別現在會在存取 exitCode getter 時拋出 StateError。
• 當未連接到子進程的 stdio (ProcessStartMode.detached 和 ProcessStartMode.inheritStdio) 時，Process 類別現在也會在存取 stdin、stdout 和 stderr getter 時拋出錯誤。
• 如果 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 作為 stream。

• Kernel AST API 中 InstanceConstant 類別上的 klass getter 已重新命名為 classNode，以保持一致性。
• 更新了 Link 實作，以在 Windows 上利用真正的符號連結而不是接合點。

• 現在添加到已關閉的 IOSink 會拋出 StateError.

• 修正了使用 dart:mirrors 反射性地以不正確的方式調用方法時的健全性漏洞，該方式違反了其靜態類型。

• 許多應該被檢測和報告的靜態錯誤在 2.0.0 中不受支援。 這些錯誤現在會被報告，這表示現有的不正確程式碼可能會顯示新的錯誤
  • Mixins 必須正確地覆寫其超類別.
  • extends 子句中的隱含類型引數必須滿足類別邊界.
  • 實例成員應遮蔽前綴.
  • 建構子調用必須使用有效的語法，即使使用可選的 new 也是如此.
  • 泛型 typedef 的類型引數必須滿足其邊界.
  • 類別不能實作 FutureOr.
  • 抽象方法不得以不健全的方式覆寫具體方法.
  • 常數建構子不能重新導向到非常數建構子.
  • 不允許使用與封閉類別同名的 setter.

• 不允許在 const map 中使用重複的鍵，並且會產生編譯時期錯誤。

• 用使用類型推斷和運行時檢查的健全靜態類型系統取代了不健全的可選靜態類型系統，以前稱為 強模式。
• 標記為 async 的函數現在同步運行，直到第一個 await 語句。

• 將核心程式庫中的常數從 SCREAMING_CAPS 重新命名為 lowerCamelCase。
• 在核心程式庫類別中新增了許多新方法，如果您實作這些類別的介面，則需要實作這些方法。
• 使用 Dart for Web 時，不再支援 dart:isolate 和 dart:mirrors。

• 用 新的建置系統 取代了 pub 基於轉換器的建置系統。

除非另有說明，否則本網站上的文件反映的是 Dart 3.7.1。 頁面上次更新於 2025-02-12。 查看原始碼 或 回報問題。