Flutter dev_dependencies引入包后Dart analysis失效如何解决

• 版本兼容冲突是最高发诱因：flutter_native_splash部分历史版本存在内置分析配置逻辑bug，当安装的包版本和本地Flutter/Dart SDK版本不匹配时，会打断Dart Analysis Server的正常规则加载流程，最终仅能识别基础语法错误，const缺失、代码风格不规范这类lint规则完全无法触发。
• 生成文件未做扫描排除：执行包的生成命令后，会在项目多个目录下产出自动生成的模板代码（含Dart端、Android/iOS原生端配置文件），如果没有在分析配置里标记这些文件为忽略项，分析器扫描大量未适配lint规则的生成代码时，容易触发内存超限、扫描进程假死，最终仅返回极少量分析结果。
• 配置被隐式覆盖：部分版本的flutter_native_splash执行生成命令时，会自动修改项目根目录的analysis_options.yaml文件，和原有引入的flutter_lints等预设规则集产生优先级冲突，导致原有的代码规范规则被覆盖失效。

• 锁定兼容的包版本：先执行flutter --version获取当前环境对应的Dart版本号，选择适配当前SDK版本区间的flutter_native_splash稳定版安装，不要直接拉取最新版出现跨大版本兼容问题。配置完成后执行flutter pub get，在IDE命令面板执行Restart Dart Analysis Server重启分析服务验证效果。
• 补全分析忽略规则：打开项目根目录的analysis_options.yaml，在analyzer节点的exclude配置中，把包生成的相关文件路径全部加入忽略列表，参考配置如下：

analyzer:
  exclude:
    - "**/*.g.dart"
    - "**/*.freezed.dart"
    - "lib/generated/**"
    - "android/app/src/main/res/drawable*/launch_background.xml"
    - "ios/Runner/Assets.xcassets/LaunchImage.imageset/**"

配置完成后删除项目根目录下的.dart_tool缓存文件夹，执行flutter pub get重新拉取依赖后重启分析服务。

• 检查并修复配置冲突：打开analysis_options.yaml确认文件顶部的lint规则引入配置没有被篡改，正常使用官方预设规则需要保留include: package:flutter_lints/flutter.yaml这行配置，如果被自动生成的内容覆盖，手动改回原有配置即可，也可以给配置文件加只读权限避免后续被自动修改。
• 排查隐藏的分析报错：在项目根目录直接执行dart analyze命令，通过终端输出的完整日志定位问题——IDE集成的分析服务假死时通常不会弹出具体报错，命令行可以直接看到是哪个文件、哪段逻辑导致扫描流程中断。
• 特殊场景调整依赖位置：如果上述操作都无效，可以把flutter_native_splash从dev_dependencies移到普通dependencies节点下，部分低版本Flutter环境中，带原生构建逻辑的开发依赖会触发分析服务的依赖扫描异常，调整位置不会影响包的正常使用，也能规避扫描冲突。

内容的提问来源于stack exchange，提问作者Sittiphan Sittisak