Pular para o conteúdo principal

no_leading_underscores_for_local_identifiers

Saiba mais sobre a regra de lint no_leading_underscores_for_local_identifiers.

Estável
Recomendado
Correção disponível
Lançado no Dart 2.16

Evite sublinhados iniciais em identificadores locais.

Detalhes

#

NÃO FAÇA use sublinhado inicial em identificadores que não sejam privados. O Dart usa um sublinhado inicial em um identificador para marcar membros e declarações de nível superior como privados. Isso ensina os usuários a associar um sublinhado inicial a esse tipo de declaração: eles veem _ e pensam "privado". Não existe o conceito de "privado" para variáveis locais ou parâmetros. Quando um deles tem um nome que começa com sublinhado, ele transmite um sinal confuso ao leitor. Para evitar isso, não use sublinhados iniciais nesses nomes.

EXCEÇÃO: Um parâmetro não usado pode ser nomeado _, __, ___ etc. Isso é prática comum em callbacks em que você recebe um valor, mas não precisa usá-lo. Dar a ele um nome formado apenas por sublinhados é a forma idiomática de indicar que o valor não é usado.

RUIM:

dart
void print(String _name) {
  var _size = _name.length;
  ...
}

BOM:

dart
void print(String name) {
  var size = name.length;
  ...
}

OK:

dart
[1,2,3].map((_) => print('Hello'));

Ativar

#

Para ativar a regra no_leading_underscores_for_local_identifiers, adicione no_leading_underscores_for_local_identifiers em linter > rules no seu arquivo analysis_options.yaml:

analysis_options.yaml
yaml
linter:
  rules:
    - no_leading_underscores_for_local_identifiers

Se você usa a sintaxe de mapa YAML para configurar as regras de lint, adicione no_leading_underscores_for_local_identifiers: true em linter > rules:

analysis_options.yaml
yaml
linter:
  rules:
    no_leading_underscores_for_local_identifiers: true

Encontrou essa página sem tradução ou que precisa de correção? Abra uma issue e nos ajude a manter esse site em PT-BR para ajudar pessoas como você.