跳到主要內容

require_trailing_commas

穩定
提供修正

針對所有參數列表和引數列表使用尾隨逗號。

詳細資訊

#

務必針對所有多行參數列表和引數列表使用尾隨逗號。若參數列表或引數列表(包含開頭和結尾括號)可放在單行,則不需要尾隨逗號。

不良範例

dart
void run() {
  method('does not fit on one line',
      'test test test test test test test test test test test');
}

良好範例

dart
void run() {
  method(
    'does not fit on one line',
    'test test test test test test test test test test test',
  );
}

例外:如果引數列表中的最後一個引數是位置引數(相對於具名引數),且為含大括號的函式常值、map 常值、set 常值或 list 常值,則不需要尾隨逗號。此例外情況僅適用於最後一個引數無法完整放在單行上的情況。

注意:此 lint 規則假設程式碼已使用 dart format 格式化,且可能在未格式化的程式碼上產生誤判。

啟用

#

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

analysis_options.yaml
yaml
linter:
  rules:
    - require_trailing_commas

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

analysis_options.yaml
yaml
linter:
  rules:
    require_trailing_commas: true