如何解决运行Flutter项目时出现的Viewport.dart编译报错问题

问题原因 #

该报错是本地Flutter SDK源文件被意外篡改或缓存损坏导致的，出错的viewport.dart属于Flutter框架自带的渲染层源码，官方正式发布的版本不会存在这类基础语法错误。

解决方案 #

按优先级依次尝试以下操作：

• 先执行缓存清理与修复命令，处理损坏的项目及SDK缓存：

  flutter clean
  flutter pub cache repair
  

  执行完成后重新运行项目验证是否恢复正常。
• 若上述操作无效，重置本地Flutter SDK到对应分支的正常状态：
  进入你本地Flutter SDK根目录（报错里的路径为C:\Users\ramja\Documents\DartConfig\flutterSDK\flutter），在该目录下打开终端执行：

  git reset --hard
  

  重置完成后执行flutter doctor检查SDK状态，再重新运行项目。
• 若依然报错，直接卸载现有Flutter SDK，重新下载对应稳定版本SDK配置环境即可。

内容的提问来源于stack exchange，提问作者Fsd Ramjan