使用 dart format 指令,將程式中的空白字元替換為符合 Dart 指南 的格式。這是使用支援 Dart 的 IDE 或編輯器時可以取得的相同格式。

提供檔案或目錄清單給 dart format 指令。例如,以下是格式化目前目錄中或目錄下的所有 Dart 檔案的方法

$ dart format .

若要指定多個檔案或目錄,請使用空白分隔清單。下列指令格式化 lib 目錄下的所有 Dart 檔案,以及 bin 目錄下的其中一個 Dart 檔案

$ dart format lib bin/updater.dart

如果您不想要覆寫檔案,請加入 --output-o 旗標。使用 -o show-o json 取得已格式化檔案的內容,或使用 -o none 僅查看哪些檔案會變更。

$ dart format -o show bin/my_app.dart

若要讓指令在發生任何格式化變更時傳回 1 的結束代碼,請加入 --set-exit-if-changed 旗標。此結束代碼通常用於持續整合 (CI) 以表示檢查應該失敗。

$ dart format -o none --set-exit-if-changed bin/my_app.dart

有關其他命令列選項的資訊,請使用 dart help 指令或參閱 dart_style 套件 的文件。

$ dart help format