no_ leading_ underscores_ for_ local_ identifiers
Saiba mais sobre a regra de lint no_leading_underscores_for_local_identifiers.
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:
void print(String _name) {
var _size = _name.length;
...
}
BOM:
void print(String name) {
var size = name.length;
...
}
OK:
[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:
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:
linter:
rules:
no_leading_underscores_for_local_identifiers: true
Salvo indicação em contrário, a documentação neste site reflete Dart 3.13.7. Relatar um problema.
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ê.