Marswill

编写高质量的Dart正在针当前实践和Dart2在更新。如果你发现了一些没有被发现的问题，请提交bug。 在过去的几年中，我们已经编写了大量的Dart代码，并且了解了很多关于哪些代码有效，哪些代码无效。我们将与您分享这一点，以便您也可以编写一致的、健壮的、快速的代码。主要有两个主题: 一致的：当涉及到格式化和大小写时，关于哪个更好的争论是主观的，并且不可能解决。我们所知道的是保持一致在...

标识符 大驼峰命名法 使用小写加下划线来命名库和源文件 使用小写加下划线来命名导入前缀。 使用小驼峰法命名其他标识符。 优先使用小驼峰法作为常量命名。 大写缩写和缩写长于两个字母就像单词那样 不使用前缀字母 排序 在其他引入之前引入所需的dart库 在相对引入之前先引入在包中的库 第三方包的导入先于其他包 在所有导入之后，请在单独的部分中指定导出 按字母顺序排序块 格式化 使用dar...

注释 要像句子一样格式化评论。 不要在文档中使用块注释。 Doc注释 使用///文档注释来记录成员和类型。 优先为公共api编写文档注释。 考虑写一个库级别的文档注释 考虑为私有api编写文档注释。 用一句话总结开始doc注释。 一定要把“doc注释”的第一句话分隔成自己的段落。 避免与周围的上下文冗余。 优先用第三人称动词开始函数或方法注释。 优先用名词短语开始变量、getter或se...

一定要在部分指令中使用字符串。 不要导入位于另一个包的src目录中的库。 优先在导入包的lib目录中的库时，选择相对路径。 这些指南帮助您以一致的、可维护的方式将多个文件组成程序。为了使这些指南简洁，他们使用“import”来涵盖import和export指令。这两项准则同样适用。 一定要在部分指令中使用字符串。 许多Dart开发人员完全避免使用part。他们发现，当每个...

使用相邻字符串连接字符串文字。 优先使用插值来组合字符串和值。 在不需要时，避免在插值中使用花括号。 以下是在Dart中编写字符串时需要记住的一些最佳实践。 使用相邻字符串连接字符串文字。 如果有两个字符串字面值(不是值，而是实际引用的字面值)，则不需要使用+连接它们。就像在C和c++中，简单地把它们放在一起就能做到。这是创建一个长字符串很好的方法但是不适用于单独一行。 ...