“在源代码编辑器中输入或自动生成代码的时候,代码会按照某些方式进行格式化,这个过程就被称作格式化代码。 目的是,增强可读性。 代码格式化,主要是整理原代码的缩进,以及运算符的间隔等。 目的是使代码缩进清晰,更容易阅读。”
通过自动格式化代码来保证统一的代码样式,如果没有统一的代码样式,当进行代码审查的时候,可能会为了一些样式的问题而进行争论,从而浪费时间。代码审查最好把时间花在代码的行为上,而不是代码的样式上。
1. 在 Android Studio / IntelliJ 中自动格式化代码
格式化当前窗口中代码的方法是先在代码窗口中单击右键,然后选择 Reformat Code with dartfmt 选项即可。也可以在 IntelliJ 的偏好设置里的 Keymap 部分中增加快捷键,然后使用快捷键操作。
2. 在 VS Code 中自动格式化代码
在 VS Code 中安装 Flutter)来进行代码的自动格式化。
格式化当前窗口中代码的方法是先在代码窗口中单击右键,然后选择 Format Document 选项即可。也可以在 VS Code 的偏好设置里面增加快捷键,然后使用快捷键操作。
将 editor.formatOnSave 设置成 true,可以在保存文件的时候自动进行代码格式化。
3. 使用 ‘flutter’ 命令自动格式化代码
我们也可以在命令行界面(CLI)中使用 flutter format 命令,进行代码的自动格式化。
4. 末尾处添加逗号
Flutter 代码经常会构建一定深度的树形数据结构,如在 build 方法中。为了有更好的自动格式化效果,我们推荐在末尾处添加逗号,尽管也可以不这样做。规则也比较简单:总是在函数、普通方法、构造方法参数列表的末尾处添加逗号。这样做会使格式化工具自动插入一些换行符,使代码更具有 Flutter 风格。