Ubuntu通过snap安装Flutter后终端运行flutter命令报错如何解决？

错误根因说明 #

本次报错核心是snap版Flutter首次初始化时拉取版本发布元数据失败，导致解析版本hash的jq命令传入了空值，触发语法错误，后续下载、解压步骤全部连锁失败。

解决步骤 #

第一步：清理损坏的安装残留 #

• 卸载当前有问题的snap版Flutter：
  sudo snap remove flutter
• 删除本地残留的缓存和配置文件：

rm -rf ~/snap/flutter/common/flutter
rm -rf ~/.flutter

第二步：重新安装snap版Flutter #

• 执行标准snap安装命令：
  sudo snap install flutter --classic
• 执行snap刷新命令确认安装包完整性：
  sudo snap refresh flutter

第三步：配置环境并完成初始化 #

• 国内用户需要先配置镜像加速，避免拉取资源失败，在~/.bashrc（bash用户）或~/.zshrc（zsh用户）末尾添加以下配置：

export PUB_HOSTED_URL=https://pub.flutter-io.cn
export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn

• 重载shell配置使环境变量生效：
  source ~/.bashrc
  （zsh用户替换为source ~/.zshrc）
• 执行flutter初始化校验命令：
  flutter doctor

备用解决方案 #

如果上述步骤仍无法解决问题，可放弃snap安装方式，改用官方压缩包手动安装：

1. 下载对应CPU架构的Flutter稳定版压缩包
2. 解压到本地自定义目录，例如~/opt/flutter
3. 将Flutter的bin目录路径添加到系统PATH环境变量即可
4. 执行flutter doctor完成初始化

内容的提问来源于stack exchange，提问作者Arshia Ramezan Mahmoodi