Marswill

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

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

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

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

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

译注：本文来自phpocean，使用机翻后由Mr.Wei校对。[语言往往给程序员带来的成就感往往让其忘了初衷，当你不再买各种《XXX从入门到精通》就说明你要么放弃了要么明白了。_] 我们都是程序员，我们都是学习者。看到有多少人(学习者)把时间浪费在毫无意义的事情上（bashing their head against the walls），以为自己在学习编程，这真是令人惊讶。 您可能正在学习一...

译注：Dart2.0的文档已经翻译发布有半年之久了，2018年11月Dart2.1的stable版本也发布了。2.0版本的文档地址在https://www.kancloud.cn/@marswill 今天，我们宣布Dart 2.1的稳定发行版，这是Dart 2的升级版，它提供了更小的代码大小、更快的类型检查、更好的类型错误可用性以及在构建用户体验时提高生产率的新语言特性。 Dart2回顾 D...