跳至主要內容

lines_longer_than_80_chars

穩定版

避免使用超過 80 個字元的行。

詳細資訊

#

避免 行長度超過 80 個字元

可讀性研究顯示,文字行太長會更難閱讀,因為眼睛在移動到下一行開頭時必須移動更遠的距離。這就是報紙和雜誌使用多欄文字的原因。

如果您真的發現自己想要使用超過 80 個字元的行,我們的經驗是您的程式碼可能太冗長,可以更精簡一些。最常見的罪魁禍首通常是 VeryLongCamelCaseClassNames。問問自己:「該類型名稱中的每個字詞都告訴我一些關鍵資訊,還是防止名稱衝突?」如果不是,請考慮省略它。

請注意,dart format 會為您完成 99% 的工作,但最後 1% 還是要靠您。它不會分割長字串文字以符合 80 欄的限制,因此您必須手動執行此操作。

我們對 URI 和檔案路徑做例外處理。當這些出現在註解或字串中(通常在匯入和匯出中)時,即使它們超過行長度限制,它們也可以保留在單行上。這使得在原始碼檔案中搜尋給定路徑更容易。

啟用

#

若要啟用 lines_longer_than_80_chars 規則,請在您的 analysis_options.yaml 檔案中的 linter > rules 下方新增 lines_longer_than_80_chars

analysis_options.yaml
yaml
linter:
  rules:
    - lines_longer_than_80_chars

如果您改為使用 YAML map 語法來設定 linter 規則,請在 linter > rules 下方新增 lines_longer_than_80_chars: true

analysis_options.yaml
yaml
linter:
  rules:
    lines_longer_than_80_chars: true