在 macOS 上通过 FVM 正确配置全局 Flutter SDK 的方法
在 macOS 系统中使用 FVM（Flutter Version Management）管理多个 Flutter 版本时，常常遇到即使执行了 fvm use --global 命令，系统仍然无法识别 flutter 命令的情况。此类问题通常是由于环境变量未正确配置，导致系统未能找到 FVM 创建的全局符号链接。
常见错误表现
用户可能会发现：
- 执行
flutter doctor提示命令不存在； - 虽然设置了全局版本，但实际使用的仍是其他本地版本；
- 不同终端窗口行为不一致。
FVM 全局版本的工作原理
FVM 会为所选版本创建一个软链接：~/.fvm/flutter_sdk，该链接指向具体的 Flutter SDK 版本目录。例如：
lrwxr-xr-x 1 user staff 28 Apr 5 10:20 /Users/user/.fvm/flutter_sdk -> versions/3.10.0但是，这个路径并不会自动加入系统的 PATH 变量中，需要手动添加才能让命令行工具识别。
配置 Shell 环境以支持全局版本
首先确定你正在使用的 shell 类型：
echo $SHELL如果你使用的是 zsh，则编辑 ~/.zshrc 文件；如果是 bash，则应编辑 ~/.bash_profile。
向文件末尾追加以下内容：
# 设置 FVM 路径相关环境变量
export FVM_ROOT="$HOME/.fvm"
export PATH="$FVM_ROOT/flutter_sdk/bin:$PATH"
export PUB_CACHE="$FVM_ROOT/.pub-cache"保存更改后，在终端中重新加载配置：
source ~/.zshrc验证配置是否生效
完成上述操作后，请依次运行下列命令进行验证：
| 检查项目 | 命令 | 预期结果 |
|---|---|---|
| 软链接目标 | readlink ~/.fvm/flutter_sdk |
显示类似 versions/3.10.0 |
| Flutter 命令位置 | which flutter |
返回 /Users/<username>/.fvm/flutter_sdk/bin/flutter |
| Flutter 版本信息 | flutter --version |
展示与 FVM 设置相同的版本号 |
| 环境变量是否包含 FVM 路径 | echo $PATH | grep fvm |
输出中包含 .fvm/flutter_sdk/bin |
特殊情况处理
某些开发环境中（如 IDE、CI 流水线），可能不会加载用户的 shell 配置文件。这时可以采取以下方式解决：
- VS Code 用户： 在设置中指定 Flutter SDK 路径：
"dart.flutterSdkPath": "/Users/<your_user_name>/.fvm/flutter_sdk" - 持续集成脚本中： 显式地导入环境变量或直接调用完整路径；
- 替代方案： 使用
fvm flutter替代原生flutter命令来绕过路径查找过程。
如果遇到权限问题，请确保 .fvm 目录具有正确的访问权限：
chmod -R 755 ~/.fvm
chown -R $(whoami) ~/.fvm