如何在Android Studio中解决Flutter报错“No pubspec.yaml file found”

排查解决步骤 #

• 首先确认终端当前工作路径是否为项目根目录
  执行pwd（macOS/Linux）或cd（Windows cmd/PowerShell）查看当前路径，确认路径精确匹配项目根目录（即包含pubspec.yaml的最上层目录），不要在项目的子目录（比如lib、test文件夹）或上一级目录执行Flutter命令。可以执行ls（macOS/Linux）或dir（Windows）查看当前目录的文件列表，确认能看到pubspec.yaml文件再执行相关命令。
• 检查pubspec.yaml文件名是否符合要求
  确认文件名是全小写的pubspec.yaml，没有多余后缀（比如不小心存成了pubspec.yaml.txt），也没有大小写错误（比如Pubspec.yaml、pubspec.YAML），大小写不匹配在macOS/Linux等大小写敏感的系统下会直接导致识别失败。
• 验证文件读取权限
  确认当前终端使用的用户账号对项目目录、pubspec.yaml文件有可读权限，macOS/Linux下可执行ls -l pubspec.yaml查看权限配置，Windows可右键文件打开「属性」-「安全」选项卡核对权限。
• 检查pubspec.yaml文件完整性
  打开文件确认内容没有损坏、为空或存在严重的格式错误，如果文件损坏可以从Git提交历史或备份中恢复正常的配置文件。
• 清理项目缓存重试
  如果以上排查都无问题，删除项目下的.dart_tool、.pub、build缓存文件夹，再重新在项目根目录执行flutter pub get验证，缓存错乱也可能引发路径识别异常。
• 特殊环境适配
  如果你使用WSL、Linux子系统、终端路径映射类工具，建议直接用绝对路径切换到项目根目录再执行命令，避免跨系统路径解析、虚拟路径映射导致的识别失败。

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