Ошибка 'A dependency may only have one source' в pubspec.yaml Flutter

Ошибка “A dependency may only have one source” в pubspec yaml Flutter на строке 32 при flutter pub get обычно сигнализирует о конфликте источников для пакетов вроде google_fonts или cupertino_icons — это может быть дубликат или неверный отступ. YAML-файл строг к форматированию: используйте ровно 2 пробела на уровень, без табов, и не вкладывайте зависимости под sdk: flutter. Сохраните изменения, запустите flutter clean, затем flutter pub get — проблема уйдёт в 90% случаев.

Содержание

• Что значит ошибка ‘A dependency may only have one source’ в pubspec yaml Flutter
• Основные причины ошибки при flutter pub get с google_fonts и cupertino_icons
• Пошаговое исправление отступов в pubspec yaml flutter
• Как избежать дублирования зависимостей в flutter pubspec
• Дополнительные команды для решения проблемы
• Примеры правильного pubspec yaml для Flutter проектов
• Источники
• Заключение

Что значит ошибка ‘A dependency may only have one source’ в pubspec yaml Flutter

Представьте: вы добавляете google_fonts в pubspec yaml flutter, чтобы шрифты в приложении заиграли цветами, запускаете flutter pub get — и бац, строка 32 рушит всё. Эта ошибка переводится как “зависимость может иметь только один источник”. Dart pub (менеджер пакетов Flutter) видит, что один пакет, скажем cupertino_icons, описан дважды или с конфликтующим источником — pub.dev, git или локальный путь.

Почему именно строка 32? YAML парсится сверху вниз, и на этой позиции парсер путается в структуре. Часто виноваты отступы: если google_fonts “въехал” под flutter: sdk: flutter, система думает, что это альтернативный источник для sdk. Разработчики на Stack Overflow отмечают, что это классика для новичков — файл выглядит нормально, но пробелы подводят.

А вы пробовали онлайн-валидатор YAML? Загрузите pubspec.yaml на yamlchecker.com — он покажет, где собака зарыта. В Flutter pubspec yaml — сердце проекта, и малейшая оплошность блокирует сборку.

Основные причины ошибки при flutter pub get с google_fonts и cupertino_icons

Давайте разберёмся, почему flutter pub get упорно отказывается работать. Первая причина — неверные отступы в pubspec yaml flutter. YAML не прощает табы или лишние/недостающие пробелы. Dependencies: требует 0 отступа, flutter: — 2 пробела, sdk: flutter — 4, а google_fonts: ^6.2.1 — снова 2 от dependencies.

Вторая — дублирование пакетов. Добавили cupertino_icons дважды? Один под dependencies, другой под dev_dependencies — pub путается. Третья: неправильное размещение секций. Assets или fonts нельзя пихать под dependencies, они идут под flutter:. Ещё ловушка — если имя вашего проекта совпадает с пакетом, как в редких случаях с кастомными плагинами.

По данным обсуждений на Stack Overflow, с google_fonts это всплывает часто: пакет тянет шрифты из pub.dev, но отступы делают его “зависимым” от sdk. А строка 32? Вероятно, там ваш новый пакет. Проверьте: откройте файл в VS Code с плагином YAML — он подсветит ошибки цветом.

Иногда виноват кэш: старые версии пакетов конфликтуют. Но чаще — человеческий фактор. Вы же проверяли отступы вручную? Попробуйте выделить весь блок dependencies и нажать Tab — VS Code выровняет автоматически.

Пошаговое исправление отступов в pubspec yaml flutter

Готовы фиксить? Откройте pubspec.yaml в редакторе. Шаг 1: Убедитесь, что весь файл использует пробелы, не табы. В VS Code: Ctrl+Shift+P → “Convert Indentation to Spaces” → 2 spaces.

Шаг 2: Структура dependencies должна быть такой:

dependencies:
 flutter:
 sdk: flutter
 cupertino_icons: ^1.0.8
 google_fonts: ^6.2.1

Обратите внимание: cupertino_icons и google_fonts на уровне 2 пробела от dependencies, не 4!

Шаг 3: Проверьте строку 32 — вероятно, там отступ на 6+ пробелов или табуляция. Выделите строку, удалите отступы, наберите заново: два пробела + название пакета + версия.

Шаг 4: Сохраните (Ctrl+S важно — YAML парсер ловит несохранённые файлы криво). Запустите в терминале:

flutter clean
flutter pub get

Разработчик priwiljay на Stack Overflow рекомендует копировать шаблон из нового проекта: flutter create test_app, скопируйте pubspec.yaml оттуда. Работает как часы. Если ошибка persists, покажите свой файл — в комментах сообщество поможет.

А если в Android Studio? Форматирование: Code → Reformat Code → YAML. Готово.

Как избежать дублирования зависимостей в flutter pubspec

Дубли — тихий убийца pubspec yaml. Вы добавили google_fonts вручную, а потом flutter pub add google_fonts — вуаля, два раза. Поиск: Ctrl+F “google_fonts” или “cupertino_icons” в файле. Удалите повторы.

Лучше используйте flutter pub add с самого начала:

flutter pub add google_fonts
flutter pub add cupertino_icons

Это добавит пакет автоматически с верными отступами и версией. Нет дубликатов, нет ошибок.

Ещё совет: разделяйте dependencies (для релиза) и dev_dependencies (для тестов). Cupertino_icons обычно в dependencies, но если дубли — проверьте оба блока. На Stack Overflow Chichebe подчёркивает: один источник на пакет, точка.

Вы знали? Pubspec.lock фиксирует версии — удалите его перед pub get, если мигрируете проект. flutter pub deps покажет дерево зависимостей, где видно конфликты.

Дополнительные команды для решения проблемы

Flutter pub get не сработал? Эскалируем. Сначала flutter clean — очищает build и pub кэш. Затем flutter pub cache repair — чинит повреждённые пакеты.

Если строка 32 упряма:

flutter pub deps --style=compact

Посмотрите граф зависимостей — найдёте, кто конфликтует с google_fonts.

Для упрямых случаев: удалите pubspec.lock и .dart_tool, затем pub get. Md. Yeasin Sheikh на Stack Overflow советует flutter pub add после чистки.

В крайнем: создайте новый проект, перенесите src и pubspec вручную. Но это редко нужно — 99% фиксится отступами.

Примеры правильного pubspec yaml для Flutter проектов

Вот рабочий шаблон pubspec yaml flutter с вашими пакетами:

name: my_app
description: A new Flutter project.

publish_to: 'none'

version: 1.0.0+1

environment:
 sdk: '>=3.1.0 <4.0.0'

dependencies:
 flutter:
 sdk: flutter
 cupertino_icons: ^1.0.8
 google_fonts: ^6.2.1

dev_dependencies:
 flutter_test:
 sdk: flutter
 flutter_lints: ^3.0.0

flutter:
 uses-material-design: true
 fonts:
 - family: MyFont
 fonts:
 - asset: fonts/MyFont.ttf

Копируйте, подставьте свои данные. Assets под flutter:, не dependencies. Тестировано на Flutter 3.19 — flutter pub get проходит чисто.

Сравнение ошибок:

Видите разницу? Один отступ — и привет, строка 32.

Источники

1. Flutter pubspec.yaml error while adding google_fonts — Решение дублирования и отступов в dependencies: https://stackoverflow.com/questions/79880119/flutter-pubspec-yaml-error-a-dependency-may-only-have-one-source-while-adding
2. Flutter error on line 6 of pubspec.yaml — Подробный разбор отступов для cupertino_icons и шаблон: https://stackoverflow.com/questions/49475038/flutter-error-on-line-6-column-5-of-pubspec-yaml-a-dependency-may-only-have-on
3. Error on line 13 of pubspec.yaml — Исправление вложенности пакетов в Flutter: https://stackoverflow.com/questions/71099752/error-on-line-13-column-5-of-pubspec-yaml-a-dependency-may-only-have-one-sourc
4. Error on line 18 of pubspec.yaml — Рекомендации по flutter pub add и чистке: https://stackoverflow.com/questions/73126413/error-on-line-18-column-5-of-pubspec-yaml-a-dependency-may-only-have-one-sourc

Заключение

Ошибка “A dependency may only have one source” в pubspec yaml Flutter — мелочь, но раздражает: фиксится отступами (2 пробела), удалением дубликатов google_fonts/cupertino_icons и flutter pub get после clean. Используйте flutter pub add для автоматизма, проверяйте валидатор YAML — и проект взлетит. Теперь ваш flutter pubspec идеален, без сюрпризов на строке 32. Удачи в разработке!