Fork me on GitHub

dart系列之:dart代码最佳实践

简介

每种语言都有自己的代码风格,这种代码风格是跟语言特性息息相关的。如果在编码的过程中遵循这种统一的编码规则,会给我们的业务带来非常多的便利。

同样的,对应dart而已,也有属于自己的编码风格,一起来看看吧。

命名规则

一般来说,这个世界上有三种命名规则,分别是UpperCamelCase,lowerCamelCase和lowercase_with_underscores.

UpperCamelCase表示的是驼峰格式,也就是首字母大写,其他的字母小写。

而lowerCamelCase也是驼峰格式,不同的是它的第一个单词的首字母是小写的。

lowercase_with_underscores则是将单词用下划线进行连接。

对于类,typedef,枚举这些类型,一般都使用的是UpperCamelCase模式:

class ClassRoom {}

typedef Predicate<T> = bool Function(T value);

对于类的实例来说,使用lowerCamelCase:

const classRoom = ClassRoom();

对于方法名来说,也使用lowerCamelCase:

void main() {
}

之前我们讲到了dart 2.7引入的extension,extension也需要使用UpperCamelCase:

extension StringCompare on String { ... }

对于libraries, packages, 目录和源文件来说,使用lowercase_with_underscores,如下所示:

library common_convert.string_convert;

import 'lib_one.dart';
import 'lib_two.dart';

如果要将import的lib进行重命名,则需要使用lowercase_with_underscores,如下所示:

import 'lib_one.dart' as lib_one;

对于某些回调函数中的参数,如果并没有使用到的话,则可以用_来代替:

futureOfVoid.then((_) {
  print('Operation complete.');
});

如果是private属性,则推荐在名字前面加上_,表示它是一个私有值。

import中的顺序

在dart中,我们需要使用到其他的package,一般来说我们在编码过程中并不会特别注意到import的顺序。

不过dart对于import的顺序也是有推荐的。

首先 “dart:”,需要放在所有其他的import之前:

import 'dart:html';

import 'package:bar/bar.dart';

而"package:" 需要放在内部项目引用之前:

import 'package:foo/foo.dart';

import 'util.dart';

如果需要导出的话,export需要和import区分开:

import 'src/foo_bar.dart';

export 'src/error.dart';

然后按照上面提到的顺序对具体的import按字母表的顺序进行排序。

格式化

对于dart来说,dart语言本身是不识别空格的,但是对于人类来说,需要通过空格来格式化代码,从而达到可良好阅读的目的。

为了统一格式,dart提供了dart format命令.

虽然dart format命令为你做了99%的工作,但是还有1%的工作是你需要自己做的 。

比如:一行不超过80个字符,所有的流控制语句都用大括号括起来等等其他一些要注意的工作。

总结

以上就是dart中的代码风格总结。

本文已收录于 http://www.flydean.com/27-dart-style/

最通俗的解读,最深刻的干货,最简洁的教程,众多你不知道的小技巧等你来发现!

欢迎关注我的公众号:「程序那些事」,懂技术,更懂你!

posted @ 2022-01-04 09:31  flydean  阅读(397)  评论(1编辑  收藏  举报