程式碼格式化
雖然你的程式碼可以遵循任何偏好的風格,但根據我們的經驗,開發團隊會發現以下做法更有效率:
- 採用單一且共用的程式碼風格,並且
- 透過自動格式化來強制執行這個風格。
否則,團隊經常會在程式碼審查時陷入冗長的格式討論,而這些時間其實更應該花在討論程式行為而非程式風格上。
在 VS Code 中自動格式化程式碼
#安裝 Flutter 擴充套件(請參閱 VS Code setup),即可在 VS Code 中自動格式化程式碼。
若要自動格式化目前原始碼視窗中的程式碼,請在程式碼視窗中按右鍵,然後選擇 Format Document。 你也可以在 VS Code 偏好設定中為此功能新增鍵盤快捷鍵。
若要在每次儲存檔案時自動格式化程式碼,請將 editor.formatOnSave 設定設為 true。
在 Android Studio 和 IntelliJ 中自動格式化程式碼
#安裝 Dart 外掛程式(請參閱 Android Studio and IntelliJ setup),即可在 Android Studio 和 IntelliJ 中自動格式化程式碼。 若要格式化目前原始碼視窗中的程式碼:
- 在 macOS 上,請按下 Cmd + Option + L。
- 在 Windows 和 Linux 上,請按下 Ctrl + Alt + L。
Android Studio 和 IntelliJ 也在 macOS 的 偏好設定或 Windows 和 Linux 的 設定中的 Flutter 頁面,提供名為 Format code on save 的勾選框。 啟用此選項後,每當你儲存檔案時,會自動修正目前檔案的格式。
使用 dart 指令自動格式化程式碼
#若要在命令列介面(Command Line Interface)中修正程式碼格式,請執行 dart format 指令:
dart format path1 path2 [...]若想進一步瞭解 Dart formatter,請參閱 dart.dev 文件中的 dart format。