跳到主内容

lines_longer_than_80_chars

稳定

避免行长度超过 80 个字符。

详情

#

避免行长度超过 80 个字符

可读性研究表明,过长的文本行阅读起来更困难,因为当你移到下一行的开头时,眼睛需要移动更远的距离。这就是为什么报纸和杂志使用多列文本的原因。

如果你确实发现自己想要超过 80 个字符的行,我们的经验是你的代码可能过于冗长,可以稍微精简一下。罪魁祸首通常是 VeryLongCamelCaseClassNames。问问自己,“这个类型名称中的每个词都告诉我一些关键信息,或者防止名称冲突吗?”如果不是,考虑省略它。

请注意,dart format 会为你完成 99% 的工作,但剩下的 1% 需要你自己来做。它不会分割长的字符串字面量以适应 80 列,所以你需要手动进行。

我们对 URI 和文件路径做了例外处理。当它们出现在注释或字符串中(通常在导入和导出中)时,即使超过行限制,它们也可以保留在一行上。这使得更容易在源文件中搜索给定的路径。

启用

#

要启用 lines_longer_than_80_chars 规则,在你的 analysis_options.yaml 文件中,将 lines_longer_than_80_chars 添加到 linter > rules 下方

analysis_options.yaml
yaml
linter:
  rules:
    - lines_longer_than_80_chars

如果你正在使用 YAML 映射语法配置 linter 规则,则在 linter > rules 下方添加 lines_longer_than_80_chars: true

analysis_options.yaml
yaml
linter:
  rules:
    lines_longer_than_80_chars: true