FVM 使用说明Windows / 独立安装适用于 FVM4.x如 4.0.5。推荐使用 GitHub Releases 的Windows 独立安装包不要与dart pub global activate fvm混用两套并存时容易指到旧版。介绍FVMFlutter Version Management是 Flutter 的版本管理工具作用类似 Node 的 nvm在同一台电脑上安装、切换多套 Flutter SDK并按项目锁定版本。解决什么问题不同项目依赖不同 Flutter 版本例如 A 要 3.7B 要 3.22避免全局只装一套 SDK、来回卸载/重装团队统一项目所用 SDK减少「我这边能跑你那边不行」能做什么能力说明多版本并存多个 Flutter SDK 缓存在本地如...\fvm\versions\按项目切换fvm use 版本项目目录下用对应 SDK统一调用fvm flutter .../fvm dart ...走当前项目配置的 SDK自定义源fvm fork可接官方仓、鸿蒙适配仓或本地 git 仓和「直接装 Flutter」的区别全局 Flutter系统里通常一套改版本影响所有项目FVM每个项目可指定自己的版本日常尽量用fvm flutter而不是裸的flutter一句话FVM 给 Flutter 用的多版本管理器方便本地开发和鸿蒙/官方多套 SDK 并存。1. 下载与安装打开https://github.com/leoafarias/fvm/releases下载对应系统的 Windows 包如fvm-*-windows-x64.zip解压到固定目录例如D:\Tools\fvm目录内应有fvm.exe下次升级的时候还是去官网下载对应的电脑版本下载然后替换掉这个目录里面的内容2. 配置环境变量2.1 把 FVM 加入 PATH必做否则终端会提示找不到fvm命令。右键「此电脑」→「属性」→「高级系统设置」→「环境变量」在「用户变量」或「系统变量」中编辑Path新建一条指向fvm.exe所在目录例如D:\Tools\fvm确定保存后关闭并重新打开所有终端必要时重启 IDE验证where.exe fvm fvm--versionwhere.exe fvm的第一条应是你刚配置的独立安装路径。2.2 自定义 SDK 缓存目录可选默认缓存一般在用户目录下。若希望装到指定盘项示例变量名FVM_CACHE_PATH变量值E:\tools\fvm缓存根目录不要写成...\versions实际 SDK 会装在%FVM_CACHE_PATH%\versions\例如E:\tools\fvm\versions\oh_flutter\oh-3.27.0-release修改后同样需要重开终端。也可用fvm config--cache-path E:\tools\fvm3. 配置仓库别名forkFVM 4.x 要求地址为合法 Git URL且以.git结尾。本地路径不能直接写E:\xxx必须用file:///形式。3.1 本地仓库fvm fork add oh_flutter file:///F:/0814_Flutter/flutter_flutter/.git说明使用file:///三个斜杠Windows 盘符写成F:路径用/末尾必须是/.git目标目录本身需是完整 git 仓库3.2 远程仓库# 谷歌官方 Flutter SDKfvm fork add google-official https://github.com/flutter/flutter.git# 鸿蒙适配 Flutter SDKCPF-Flutterfvm fork add oh_cpf_flutter https://gitcode.com/CPF-Flutter/flutter_flutter.gitoh_flutter、google-official、oh_cpf_flutter都是自定义别名可按需命名。3.3 查看 / 删除别名fvm fork list fvm fork remove oh_flutter注意fork remove只删别名配置不会删除已安装的 SDK 目录。4. 安装指定版本格式fvm install 别名/版本或分支# 鸿蒙 fork 示例分支/标签名以仓库实际为准fvm install oh_cpf_flutter/oh-3.41.9-release fvm install oh_cpf_flutter/oh-3.35.7-release fvm install oh_cpf_flutter/oh-3.27.0-release fvm install oh_cpf_flutter/oh-3.22.3-release fvm install oh_cpf_flutter/br_3.7.12-ohos-1.1.3# 谷歌官方示例fvm install google-official/stable fvm install google-official/3.7.12如何知道能装哪些版本官方仓库可用fvm releases可按 channel 过滤例如fvm releases/fvm releases -c allfvm releases不能写成fvm releases 别名它不接受 fork 别名参数。自定义 fork鸿蒙等到对应 Git 仓库查看分支 / Tag再用别名/分支名安装。同一分支若要更新到远程最新内容先fvm remove 别名/版本再重新fvm install。只更新本地源仓库代码不会自动更新 FVM 已安装缓存。5. 卸载已安装的 Flutter SDKfvm remove oh_cpf_flutter/oh-3.22.3-release fvm remove 别名/版本若提示Deletion failed多半是该 SDK 正被 Cursor/VS Code 的 Dart 分析服务、Flutter daemon 占用。先关闭相关 IDE/进程再删或直接删除对应目录Remove-Item-Recurse-Force E:\tools\fvm\versions\别名\版本删除某个别名下全部版本FVM 无官方一键命令可删整个别名目录Remove-Item-Recurse-Force E:\tools\fvm\versions\oh_cpf_flutter不要用fvm remove --all/fvm destroy除非你确认要清空所有别名的缓存。6. 查看已安装版本fvm list关注表格中的Version、Local当前项目所用会有标记等列。7. 切换项目使用的版本在项目根目录执行Version列内容可直接复制fvm use google-official/3.7.12可选全局默认fvm global google-official/3.7.12检查是否切换成功fvm flutter--version fvm flutter doctor-v日常命令请通过 FVM 调用例如fvm flutter pub get fvm flutter build hap8. 常见问题8.1 终端提示找不到fvm命令检查 PATH 是否包含fvm.exe所在目录重开终端 / 重启 IDE / 必要时注销或重启电脑用where.exe fvm确认实际调用的是哪一个避免指到旧的Pub\bin\fvm.bat8.2fvm use提示无权创建符号链接推荐开启 Windows 开发人员模式设置 → 系统 → 开发者选项或搜索「开发人员模式」→ 打开。开启后普通权限即可创建符号链接。备选以管理员身份运行终端再执行fvm use。切换成功后在fvm list中对应版本的 Local 列一般会有标记。8.3 切换版本异常可尝试删除项目根目录下的.fvm与.fvmrc再重新执行fvm use 别名/版本8.4 想把别名oh_cpf_flutter改成oh_flutterFVM 无 rename需删旧别名 → 用新名字fork add→ 如需保留已装 SDK将versions\oh_cpf_flutter重命名为versions\oh_flutter并改项目.fvmrc中的版本字符串。9. 常用命令速查命令作用fvm --version查看 FVM 版本fvm fork add 别名 url.git添加仓库别名fvm fork list查看别名fvm fork remove 别名删除别名不删已装 SDKfvm install 别名/版本安装 SDKfvm remove 别名/版本卸载某个 SDKfvm list查看已安装 SDKfvm use 别名/版本当前项目切换版本fvm global 别名/版本设置全局默认版本fvm flutter ...用当前项目 SDK 执行 flutterfvm releases查看官方可安装的发布版本非 fork 分支列表