jiu/docs/review/lint-report.md

Lint 检查报告 — 2026-07-03

Go 后端

✅ 全部通过

• gofmt -l .：无格式问题
• go vet ./...：无问题

Flutter 前端

✅ 已自动修复

• dart format lib test：70 个文件格式化
• dart fix --apply --code=unnecessary_import：移除 10 处多余 import（涉及 kpi_card / label_preview_dialog / wheel_date_picker / product_detail_screen 及 5 个 test 文件）
• client/pubspec.yaml：修正 flutter_web_plugins: any → sdk: flutter（原写法导致 flutter pub get 直接失败，属本轮未提交改动引入的构建阻断问题；pubspec.lock 随之更新）

⚠️ 需要手动修复（warning，本轮改动文件）

• client/test/product_repository_test.dart:142 / :161：unnecessary_type_check——类型判断结果恒为 true，断言无效，建议改为有意义的断言或删除

⚠️ 需要手动修复（warning，存量代码，非本轮改动）

• client/lib/core/platform/single_instance.dart:7：unused_element——私有声明 _server 未被引用

ℹ️ info 级别（82 处，不阻断 DoD，择机清理）

• use_build_context_synchronously ×46：主要集中在 stock_in_list_screen.dart / stock_out_list_screen.dart 的 async 回调中跨 await 使用 context（mounted 检查对象不匹配）
• prefer_const_constructors ×19 + prefer_const_literals_to_create_immutables ×1
• deprecated_member_use ×7：withOpacity → withValues()（inventory_check_screen / label_preview_dialog / multi_select_dropdown / order_print_preview_dialog）
• curly_braces_in_flow_control_structures ×7
• no_wildcard_variable_uses ×2：app_shell.dart:581/586 引用了通配符变量 _

重点关注目录

• client/lib/screens/auth/、client/lib/widgets/ds/：零问题，干净

结论

0 error；3 处 warning 需手动处理（2 处在本轮改动的测试文件、1 处存量）；pubspec 构建阻断问题已修复。整体可提交。