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:
// ignore:missing_prefix_in_deferred_import
/// @docImport 'package:meta/meta.dart' deferred;
library;
Common fixes
#Remove the deferred
keyword:
/// @docImport 'package:meta/meta.dart';
library;
Unless stated otherwise, the documentation on this site reflects Dart 3.9.2. Page last updated on 2025-9-1. View source or report an issue.