🛠️ 手动编辑 Flutter 配置文件 【fvm 配置 java】
🎯 场景说明
当 Flutter 无法正确检测到 Android Studio 或其内置的 JDK（Java 运行时）时，可以通过手动编辑配置文件的方式显式指定相关路径。
📄 配置文件路径
在 Windows 系统中，Flutter 的配置文件通常位于：
%USERPROFILE%\.flutter_settings
💡 该文件是一个 JSON 格式的配置文件，用于存储 Flutter 的本地环境设置。
✏️ 编辑方法
使用 PowerShell 打开配置文件：
code "$env:USERPROFILE\.flutter_settings"
上述命令会用 VS Code 打开该配置文件。 若未安装 VS Code，可改用记事本：
notepad "$env:USERPROFILE\.flutter_settings"
⚙️ 示例配置内容
{
"android-studio-dir": "D:\\application\\AndroidStudio",
"android-java-binary": "D:\\application\\AndroidStudio\\jbr\\bin\\java"
}
🧩 字段说明
| 字段 | 说明 |
|---|---|
"android-studio-dir" | 指定 Android Studio 的安装路径 |
"android-java-binary" | 指定 Android Studio 内置 JBR（JetBrains Runtime）的 java 可执行文件路径 |
🚀 编辑完成后验证
完成修改后运行以下命令，验证配置是否生效：
flutter doctor
若输出检测到正确的 Android Studio 路径与 JDK，则配置成功 ✅
✅ 小结
| 步骤 | 操作 |
|---|---|
| 1️⃣ | 打开配置文件：%USERPROFILE%\.flutter_settings |
| 2️⃣ | 手动加入 android-studio-dir 与 android-java-binary |
| 3️⃣ | 执行 flutter doctor 验证配置是否生效 |
🧭 Flutter 环境管理 — 使用 FVM 管理 Flutter 版本
一、📦 什么是 FVM
FVM (Flutter Version Management) 是一款可在同一台电脑上管理多个 Flutter SDK 版本的工具，方便不同项目使用不同的 Flutter 版本而互不冲突。
二、⚙️ 安装 FVM
1️⃣ 安装命令
flutter pub global activate fvm
2️⃣ 安装输出示例
Package fvm is currently active at version 3.2.1.
Downloading packages... . (2.2s)
The package fvm is already activated at newest available version.
To recompile executables, first run `flutter pub global deactivate fvm`.
Installed executable fvm.
Warning: Pub installs executables into C:\Users\fu\AppData\Local\Pub\Cache\bin, which is not on your path.
You can fix that by adding that directory to your system's "Path" environment variable.
A web search for "configure windows path" will show you how.
Activated fvm 3.2.1.
⚠️ 注意： FVM 可执行文件被安装到以下目录（Windows）：
C:\Users\<用户名>\AppData\Local\Pub\Cache\bin
需要手动将其加入系统环境变量 PATH。
三、🧰 环境变量配置（Windows）
1️⃣ 打开 系统属性 → 高级 → 环境变量（Environment Variables） 2️⃣ 在 PATH 中添加如下路径：
C:\Users\<你的用户名>\AppData\Local\Pub\Cache\bin
3️⃣ 打开新的命令行窗口，验证：
fvm --version
若正常输出版本号（例如 3.2.1），说明 FVM 安装配置成功 ✅
四、📁 项目中使用 FVM
1️⃣ 在项目根目录执行：
fvm use 3.22.4
这条命令会为项目指定一个特定的 Flutter SDK 版本（3.22.4）。
💡 FVM 会自动下载并缓存对应版本的 Flutter SDK 到 FVM 目录（默认位于：
C:\Users\<用户名>\fvm\versions\）
2️⃣ 验证当前使用的 Flutter 版本：
fvm flutter --version
若返回信息如：
Flutter 3.22.4 • channel stable • ...
说明你项目的 Flutter 版本已成功切换。
3️⃣ 获取包依赖（基于 FVM 管理的 Flutter 环境）：
fvm flutter pub get
✅ 确保所有命令均以
fvm flutter开头 （这样保证使用项目指定的 Flutter SDK，而非全局安装版本）
五、🧹 清理缓存或多余文件
如需清理项目中的 Flutter 缓存文件、强制重置状态，可使用 Git 命令：
git clean -xfd
⚠️ 警告：
- 该命令会删除所有未被 Git 跟踪的文件及文件夹；
- 清理后需重新
flutter pub get。
六、📘 常用 FVM 命令速览
| 命令 | 说明 |
|---|---|
fvm install <version> | 安装指定版本的 Flutter SDK |
fvm use <version> | 为当前项目制定使用的 Flutter 版本 |
fvm list | 查看当前本地所有已安装的 Flutter 版本 |
fvm remove <version> | 删除某个 Flutter 版本 |
fvm flutter <command> | 使用项目指定版本执行 Flutter 命令（如 build/run/pub 等） |
fvm global <version> | 设置全局 Flutter 默认版本 |
七、📎 小结
| 项目 | 内容 |
|---|---|
| 工具 | FVM（Flutter Version Management） |
| 核心作用 | 管理多个 Flutter SDK 版本、实现项目隔离 |
| 环境位置 | C:\Users\<用户名>\AppData\Local\Pub\Cache\bin |
| 验证配置 | fvm --version |
| 项目绑定版本 | fvm use <version> |
| 清理命令 | git clean -xfd （删除缓存与临时文件） |
