[BUG] How to upgrade fvm flutter?

[i11010520]

[N] at 23:19:19 ❯ fvm doctor
FVM Doctor:                                                                                                                          
-------------------------------------------------------------------------------------------------------------------------------------
Project:
┌─────────────────────────────┬────────────────┐
│ Project                     │ work           │
├─────────────────────────────┼────────────────┤
│ Directory                   │ /Users/work    │
├─────────────────────────────┼────────────────┤
│ Active Flavor               │ None           │
├─────────────────────────────┼────────────────┤
│ Is Flutter Project          │ No             │
├─────────────────────────────┼────────────────┤
│ Dart Tool Generator Version │ Not available  │
├─────────────────────────────┼────────────────┤
│ Dart tool version           │ Not available  │
├─────────────────────────────┼────────────────┤
│ .gitignore Present          │ No             │
├─────────────────────────────┼────────────────┤
│ Config Present              │ No             │
├─────────────────────────────┼────────────────┤
│ Pinned Version              │ None           │
├─────────────────────────────┼────────────────┤
│ Config path                 │ .fvmrc         │
├─────────────────────────────┼────────────────┤
│ Local cache dir             │ .fvm/versions  │
├─────────────────────────────┼────────────────┤
│ Version symlink             │ .fvm/versions  │
└─────────────────────────────┴────────────────┘


IDEs:
┌────────────────────────────────┬─────────────────────────────────────────────────────┐
│ IDEs                           │ Value                                               │
├────────────────────────────────┼─────────────────────────────────────────────────────┤
│ VSCode                         │                                                     │
├────────────────────────────────┼─────────────────────────────────────────────────────┤
│ VSCode                         │ No .vscode directory found                          │
├────────────────────────────────┼─────────────────────────────────────────────────────┤
│ IntelliJ (Android Studio, ...) │                                                     │
├────────────────────────────────┼─────────────────────────────────────────────────────┤
│ IntelliJ (Android Studio, ...) │ No local.properties file found in android directory │
├────────────────────────────────┼─────────────────────────────────────────────────────┤
│ IntelliJ (Android Studio, ...) │ No .idea folder found                               │
└────────────────────────────────┴─────────────────────────────────────────────────────┘

Environment:
┌───────────────────────┬────────────────────────────────────────┐
│ Environment Variables │ Value                                  │
├───────────────────────┼────────────────────────────────────────┤
│ Flutter PATH          │ /Users/work/fvm/default/bin/flutter │
├───────────────────────┼────────────────────────────────────────┤
│ Dart PATH             │ /Users/work/fvm/default/bin/dart    │
├───────────────────────┼────────────────────────────────────────┤
│ FVM_CACHE_PATH        │ N/A                                    │
├───────────────────────┼────────────────────────────────────────┤
│ FVM_USE_GIT_CACHE     │ N/A                                    │
├───────────────────────┼────────────────────────────────────────┤
│ FVM_GIT_CACHE_PATH    │ N/A                                    │
├───────────────────────┼────────────────────────────────────────┤
│ FVM_FLUTTER_URL       │ N/A                                    │
└───────────────────────┴────────────────────────────────────────┘
┌──────────────┬──────────────────────────────────────────────────────────────────┐
│ Platform     │ Value                                                            │
├──────────────┼──────────────────────────────────────────────────────────────────┤
│ OS           │ macos Version 26.3.1 (Build 25D2128)                             │
├──────────────┼──────────────────────────────────────────────────────────────────┤
│ Dart Locale  │ zh-Hans-CN                                                       │
├──────────────┼──────────────────────────────────────────────────────────────────┤
│ Dart runtime │ 3.11.0 (stable) (Mon Feb 9 00:38:07 2026 -0800) on "macos_arm64" │
└──────────────┴──────────────────────────────────────────────────────────────────┘

[N] at 23:19:20 ❯ fvm flutter upgrade

Your flutter checkout has local changes that would be erased by upgrading. If you want to keep these changes, it is recommended that you stash them via "git stash" or else commit the changes to a local branch. If it is okay to remove local changes, then re-run this command with "--force".

Is it normal?
What is the right way to upgrade flutter installed by fvm?

[Prince2347X]

Is it normal?
What is the right way to upgrade flutter installed by fvm?

Yeah, it's totally normal. It's basically telling you that the changes made in the flutter code locally (can be due to several reasons) will be removed when upgrading. It'll be updated to the latest changes.

Regarding updating the flutter version, I am not sure if it's recommended to update the flutter version using the fvm command but you can always remove the existing installed version and use a new updated version of flutter through fvm.

To remove an existing flutter version:

fvm remove [version]

And then

fvm use [updated_version] # whichever version you want to update