Flutter项目报错：Undefined class 'RenderContext'及相关问题求助

架构老林

2026-7-18

解决Flutter项目中RenderContext/SelectableHtml未定义等编译错误

检查依赖版本一致性
打开项目根目录的pubspec.yaml，重点排查HTML渲染相关依赖（比如flutter_html、flutter_html_all）——这类包的不同版本常出现API改名或移除情况，比如SelectableHtml在新版flutter_html中已被整合到Html组件里。
直接删除pubspec.lock文件，再执行以下命令拉取和原项目完全匹配的依赖版本：
```
rm pubspec.lock
flutter pub get
```
清理缓存彻底重建项目
先清理Flutter项目缓存：
```
flutter clean
flutter pub get
```
再清理IDE缓存：在IntelliJ/Android Studio中点击File -> Invalidate Caches...，勾选Clear file system cache and local history后重启IDE，避免缓存导致的代码识别异常。
核对Flutter SDK版本
执行flutter --version查看本地SDK版本，对比原项目要求的版本（通常项目根目录会有说明或flutter_version文件）。若版本不匹配，使用flutter downgrade <具体版本号>或flutter upgrade切换到对应版本，之后重新执行flutter clean和flutter pub get。
适配过时API调用
如果依赖包确实做了API变更，比如flutter_html 4.x版本移除了SelectableHtml，可改成以下写法：
```
Html(
  data: "<p>示例文本</p>",
  selectable: true,
);
```
针对RenderContext未定义问题，查看对应依赖包的变更日志，确认该类是否被重命名或替换，直接替换为新版本的API即可。
核对本地开发环境配置
检查Android SDK、NDK组件版本是否符合项目要求（在IDE的SDK Manager中确认）；若涉及iOS开发，确保Xcode、CocoaPods版本兼容，执行pod install更新iOS端依赖。