Flutter中LinearPercentIndicator未定义错误求助

问题背景 #

最初安装percent_indicator: ^4.2.2包后运行正常，无操作情况下突然出现报错：The method 'LinearPercentIndicator' isn't defined for the type '_MatchDetailsPageState'。使用正确导入语句import 'package:percent_indicator/percent_indicator.dart';无效，尝试导入package:percent_indicator/linear_percent_indicator.dart时提示Target of URI doesn't exist。已尝试更换包版本、清理项目、重新获取依赖、升级Flutter（当前版本3.3.3）均未解决。

排查与解决步骤 #

1. 锁定包版本并重新获取依赖 #

确保pubspec.yaml中包版本锁定为4.2.2（避免自动升级到不兼容版本）：

dependencies:
  percent_indicator: 4.2.2

执行以下命令清理并重新拉取依赖：

flutter clean
flutter pub get

若为iOS项目，额外执行：

cd ios
pod deintegrate
pod install
cd ..

2. 清理IDE缓存 #

• Android Studio/IntelliJ：点击File -> Invalidate Caches...，勾选Clear file system cache and local history后重启IDE。
• VS Code：按下Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（Mac），输入Reload Window执行。

3. 检查代码与导入 #

• 确认导入语句无拼写错误，且未误删：import 'package:percent_indicator/percent_indicator.dart';（4.2.2版本无需单独导入线性指示器的子文件，该文件不存在属于正常情况）。
• 检查当前页面代码中是否存在同名类LinearPercentIndicator，避免命名冲突。

4. 清理Flutter插件缓存 #

删除项目根目录下的.flutter-plugins和.flutter-plugins-dependencies文件，然后再次执行flutter pub get。

5. 检查依赖冲突 #

执行以下命令查看依赖树，确认percent_indicator是否被正确引入且无冲突：

flutter pub deps

若存在依赖冲突，可尝试调整其他依赖版本，或使用dependency_overrides强制指定percent_indicator版本。

内容的提问来源于stack exchange，提问作者Sebastian Cocîrlă