msys2 mingw64执行flutter upgrade报错，Git for Windows可成功

问题现象 #

在MSYS2的MinGW64子系统中使用自带Git执行flutter upgrade时，反复出现错误：

fatal: Needed a single revision

但切换到Git for Windows执行相同命令则成功，其余环境配置未发生变化。

可能原因 #

• Git版本不兼容：MSYS2的MinGW Git版本可能偏旧，Flutter的升级脚本依赖Git的特定特性（如远程分支ref解析逻辑），旧版本无法满足需求。
• Git配置差异：Git for Windows与MSYS2 Git的默认配置存在区别，比如core.longpaths、core.autocrlf等参数，Flutter脚本需要特定配置才能正确获取仓库修订版本。
• MSYS2路径转换干扰：MSYS2默认会将Windows路径转换为类Unix路径，可能导致Flutter调用Git时路径解析错误，无法定位仓库的关键元数据。
• 权限不足：MSYS2环境下的Git对Flutter安装目录的读写权限与Git for Windows不同，导致无法读取必要的Git仓库信息。

解决办法 #

1. 升级MSYS2的Git
   打开MSYS2终端，执行以下命令更新Git到最新版本：

   pacman -Syu git
   

   更新完成后再次尝试flutter upgrade。

2. 同步关键Git配置
   将Git for Windows中的核心配置同步到MSYS2 Git中，示例命令：

   git config --global core.longpaths true
   git config --global core.autocrlf false
   

   这些是Flutter官方推荐的Git配置项，可避免多数路径和换行符相关问题。

3. 禁用MSYS2路径转换
   在执行flutter upgrade前，先设置环境变量禁用路径转换：

   export MSYS_NO_PATHCONV=1
   flutter upgrade
   

   此操作可防止MSYS2的路径转换逻辑干扰Git对Flutter仓库路径的解析。

4. 修复Flutter仓库权限
   确保MSYS2用户对Flutter安装目录有完整读写权限，执行：

   chmod -R 755 /your/flutter/install/path
   

   替换/your/flutter/install/path为实际的Flutter安装路径。

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