Почему Dart Team не следует своим собственным стилевым инструкциям? Или мы все тоже должны следовать этому руководству?

Question

Не могу понять, для кого был написан стайл-гид Дарт?

Dart Style Guide

Срок PREFER Форма этого руководства:

"Рекомендации PREFER - это практики, которым вы должны следовать. Однако могут быть обстоятельства, когда имеет смысл поступить иначе. Просто убедитесь, что вы понимаете все последствия игнорирования рекомендаций, когда делаете это".

Теперь одна из основных практик, которые часто обсуждаются и, конечно же, мы должны следовать ей:

PREFER, используя var без аннотации типа для локальных переменных.

Вкратце, использовать аннотацию типа в теле функции не рекомендуется (за исключением некоторых очень специфических ситуаций).

Но когда я заглядываю в исходный код Dart SDK, я часто вижу прямо противоположное.

Просто один образец из множества других похожих.

выполнения / Lib / collection_patch.dart

Пример:

void operator []=(K key, V value) {
    int hashCode = key.hashCode; 
    List buckets = _buckets; 
    int length = buckets.length; 
    int index = hashCode & (length - 1); 
    _HashMapEntry entry = buckets[index]; 
    while(entry != null) {
      if (hashCode == entry.hashCode && entry.key == key) {
        entry.value = value; 
        return; 
      }
      entry = entry.next; 
    }
    _addEntry(buckets, index, length, key, value, hashCode); 
  }

Почему команда Dart использовала аннотации типов для локальных переменных вместо var?

Answer 1

Не могу понять, для кого был написан стайл-гид Дарт?

Это было написано для программистов Dart. Зачем? Так как..

Поскольку мы создаем экосистему кода Dart, будет полезно, если он будет следовать согласованному стилю кодирования. Специальное руководство по стилю для Dart помогает нам максимально использовать возможности, уникальные для языка, и облегчает совместную работу пользователей.

И каждый программист или команда должны или не следовать этим рекомендациям, которые являются только предположением.