64 lines
2.2 KiB
YAML
64 lines
2.2 KiB
YAML
# 根级共享 lint 配置。
|
||
# 来源：conti-docs/14-conventions-and-ci-gates.md §二
|
||
# 每个子包的 analysis_options.yaml 只写一行 include 指向本文件，禁止在子包里
|
||
# 放宽规则——放宽必须改这里，让所有人一起讨论。
|
||
|
||
include: package:flutter_lints/flutter.yaml
|
||
|
||
# ---------------------------------------------------------------------------
|
||
# 偏离文档说明（riverpod_lint 3.1.0 起的破坏性变更）
|
||
#
|
||
# 文档 03/14 写的是 `analyzer: plugins: - custom_lint` + CI 里单独跑
|
||
# `dart run custom_lint`。但 riverpod_lint 3.1.0 已经从 custom_lint 迁移到
|
||
# analysis_server_plugin：
|
||
# > `riverpod_lint` is no-longer implemented using `custom_lint`,
|
||
# > but instead `analysis_server_plugin`. —— riverpod_lint CHANGELOG 3.1.0
|
||
# 实测 riverpod_lint 3.1.8 的依赖里已无 custom_lint。
|
||
#
|
||
# 因此：插件改在下面的顶层 plugins: 段声明，规则由 `dart analyze` /
|
||
# `flutter analyze` 直接执行，CI 里不再需要独立的 custom_lint 步骤。
|
||
# 详见根目录 SCAFFOLD-NOTES.md §B。
|
||
# ---------------------------------------------------------------------------
|
||
plugins:
|
||
riverpod_lint: ^3.1.8
|
||
|
||
analyzer:
|
||
language:
|
||
strict-casts: true
|
||
strict-raw-types: true
|
||
strict-inference: true
|
||
errors:
|
||
# freezed / riverpod 生成器会在非法位置放注解，这是生成器的正常行为
|
||
invalid_annotation_target: ignore
|
||
# 下面三条从 warning 提到 error：它们几乎总是真实缺陷
|
||
unused_import: error
|
||
dead_code: error
|
||
unawaited_futures: error
|
||
exclude:
|
||
- "**/*.g.dart"
|
||
- "**/*.freezed.dart"
|
||
- "**/generated/**"
|
||
|
||
formatter:
|
||
page_width: 100
|
||
|
||
linter:
|
||
rules:
|
||
# --- 可读性 ---
|
||
- always_declare_return_types
|
||
- prefer_single_quotes
|
||
- require_trailing_commas
|
||
- directives_ordering
|
||
- sort_pub_dependencies
|
||
# --- 正确性（这几条是真正拦过线上事故的） ---
|
||
- avoid_dynamic_calls
|
||
- avoid_slow_async_io
|
||
- cancel_subscriptions
|
||
- close_sinks
|
||
- discarded_futures
|
||
- unawaited_futures
|
||
- no_adjacent_strings_in_list
|
||
- test_types_in_equals
|
||
- throw_in_finally
|
||
- unnecessary_statements
|