跳到主要內容

implementation_imports

穩定
建議

請勿從另一個套件匯入實作檔案。

詳細資訊

#

摘錄自pub 套件版面配置文件

請勿從另一個套件匯入實作檔案。

lib 內部的程式庫是公開可見的:其他套件可以自由匯入它們。但是,套件的大部分程式碼是內部實作程式庫,應該僅由套件本身匯入和使用。這些程式庫放在 lib 的子目錄 src 中。您可以在其中建立子目錄,以協助您組織內容。

您可以自由地從同一個套件中的其他 Dart 程式碼(例如 lib 中的其他程式庫、bin 中的腳本和測試)匯入位於 lib/src 中的程式庫,但您絕不應該從另一個套件的 lib/src 目錄匯入。這些檔案不是套件公開 API 的一部分,它們可能會以可能破壞您的程式碼的方式變更。

錯誤範例

dart
// In 'road_runner'
import 'package:acme/src/internals.dart';

啟用

#

若要啟用 implementation_imports 規則,請在您的 analysis_options.yaml 檔案中的 linter > rules 下新增 implementation_imports

analysis_options.yaml
yaml
linter:
  rules:
    - implementation_imports

如果您改為使用 YAML 對應語法來設定 linter 規則,請在 linter > rules 下新增 implementation_imports: true

analysis_options.yaml
yaml
linter:
  rules:
    implementation_imports: true