Ubuntu环境下执行flutter pub get/flutter doctor报错求助

可能的原因及修复步骤 #

1. 环境变量冲突 #

• 卸载Snap版本后手动安装，再重装Snap时，旧的手动安装环境变量可能残留导致冲突：
  • 终端执行 echo $PATH，检查输出是否同时包含手动安装的Flutter路径和Snap的Flutter路径
  • 编辑shell配置文件（~/.bashrc/~/.zshrc/~/.profile），删除手动安装时添加的Flutter相关环境变量，保存后执行 source ~/.bashrc（对应你的配置文件）使修改生效

2. 缓存损坏 #

• 缓存损坏是这类问题的常见诱因，不管是手动还是Snap安装都可能出现：
  • 进入项目目录执行 flutter clean 清理项目缓存
  • 运行 flutter pub cache repair 修复pub包缓存
  • Snap安装可尝试重置版本：snap refresh flutter --revision=latest/stable

3. 权限异常 #

• 手动安装时若用sudo可能导致目录权限错误，Snap安装也可能存在权限不足：
  • 检查Snap安装路径（/snap/flutter/current/）的读取权限，确保当前用户有权访问
  • 若保留了手动安装目录，执行 sudo chown -R $USER:$USER /path/to/your/manual/flutter 修正权限

4. 依赖缺失 #

• 基于同类问题的常见情况，大概率存在未配置完成的依赖：
  • 执行 flutter doctor -v 查看详细报错信息，定位具体缺失项
  • 按提示安装对应工具（如Android SDK、Android Studio组件），并执行 flutter doctor --android-licenses 接受许可证

终极排查方案 #

若以上步骤无效，彻底清理后重装：

1. 卸载Snap版本：snap remove flutter
2. 删除手动安装目录（若存在）：rm -rf /path/to/manual/flutter
3. 删除Flutter缓存目录：rm -rf ~/.flutter && rm -rf ~/.pub-cache
4. 重新安装Snap版Flutter：snap install flutter --classic
5. 运行 flutter doctor 逐步解决依赖问题

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