doc_import_cannot_be_deferred
Doc imports can't be deferred.
Description
#The analyzer produces this diagnostic when a documentation import uses the deferred
keyword.
Documentation imports can't be deferred because deferring them wouldn't impact the size of the compiled code.
Example
#The following code produces this diagnostic because the documentation import has a deferred
keyword:
dart
// ignore:missing_prefix_in_deferred_import
/// @docImport 'package:meta/meta.dart' deferred;
library;
Common fixes
#Remove the deferred
keyword:
dart
/// @docImport 'package:meta/meta.dart';
library;
Was this page's content helpful?
Thank you for your feedback!
Provide details Thank you for your feedback! Please let us know what we can do to improve.
Provide details Unless stated otherwise, the documentation on this site reflects Dart 3.8.1. Page last updated on 2025-06-23. View source or report an issue.