prefer_relative_imports

Prefer relative imports for files in lib/.

PREFER relative imports for files in lib/.

When mixing relative and absolute imports it's possible to create confusion where the same member gets imported in two different ways. One way to avoid that is to ensure you consistently use relative imports for files within the lib/ directory.

BAD:

import 'package:my_package/bar.dart';

GOOD:

import 'bar.dart';

The prefer_relative_imports rule is incompatible with the following rules:

• always_use_package_imports

To enable the prefer_relative_imports rule, add prefer_relative_imports under linter > rules in your analysis_options.yaml file:

linter:
  rules:
    - prefer_relative_imports

If you're instead using the YAML map syntax to configure linter rules, add prefer_relative_imports: true under linter > rules:

linter:
  rules:
    prefer_relative_imports: true

Unless stated otherwise, the documentation on this site reflects Dart 3.6.0. Page last updated on 2025-01-27. View source or report an issue.