离线安装.vsix文件必须通过扩展面板右上角“⋯→install from vsix”入口，不可拖拽、双击或误用code --install-extension（该命令不支持本地.vsix）。
离线安装 .vsix 文件的正确路径和入口
VS Code 离线安装扩展，必须通过「Install from VSIX」入口，不能拖拽、双击或用命令行 code --install-extension（后者只认在线 ID，不支持本地 .vsix）。打开扩展面板后，点右上角三个点 → 选 Install from VSIX...，再定位到你下载好的 flutter-*.vsix 和 dart-code-*.vsix 文件。
为什么装了 Flutter 扩展却看不到设备列表或热重载按钮
常见原因不是插件没装，而是版本不兼容或依赖未激活：
- Flutter 扩展要求 VS Code 版本 ≥ 对应
package.json中"engines": {"vscode": "^1.54.1"}指定的最低版本；若报错Unable to install extension 'dart-code.flutter' as it is not compatible with VS Code '1.51.1'，需手动解压 .vsix（改后缀为 .zip），修改package.json里的vscode版本号，再打包回 .vsix - Dart 和 Flutter 扩展必须都装，且顺序不能反：先装
dart-code.dart-code，再装dart-code.flutter；每次安装后必须彻底关闭所有 VS Code 窗口，从系统启动器重新打开，Developer: Reload Window不触发依赖初始化 - 状态栏右下角不显示
Flutter: v3.x或设备名（如iOS (mobile)），基本可判定 Flutter 扩展未真正加载
dart.flutterSdkPath 配置失败的典型表现和修复方式
即使插件装对、版本兼容，dart.flutterSdkPath 配错也会导致全部功能失效——这不是警告，是静默拒绝服务：
- 错误现象包括：
Flutter: Run Flutter Doctor命令消失、F5 调试报No debug adapter found、右键无Run 'main.dart'、终端里flutter doctor全绿但 VS Code 内始终提示Flutter SDK not found - 路径必须是绝对路径，结尾不带
/bin；Windows 用户注意反斜杠要写成双反斜杠"C:\src\flutter"，macOS/Linux 不能用~，得写全路径如/Users/xxx/development/flutter - 配置位置必须在
settings.json（不要只改 GUI 设置界面），且保存后需重启 VS Code 才生效；如果保存失败，先把package.json或settings.json文件复制到桌面编辑，再替换回去
离线环境里怎么确认 Flutter 插件真正在工作
别只看扩展列表里有没有勾选，要验证行为：
- 打开任意
.dart文件，状态栏右下角应同时显示Dart: v3.x和Flutter: v3.x（不是只有 Dart） -
Cmd+Shift+P（macOS）或Ctrl+Shift+P（Windows/Linux）输入Flutter:，应列出至少 10 条命令，如Flutter: New Project、Flutter: Run Flutter Doctor - 运行
Flutter: Run Flutter Doctor，输出内容必须和你在终端里执行flutter doctor完全一致；若提示command not found或输出为空，说明插件根本没拿到 SDK 路径
最易被忽略的一点：离线安装时，.vsix 文件本身可能来自旧版市场快照，它携带的 engines.vscode 版本号往往比你本地 VS Code 低。这时候改 package.json 不是“黑科技”，是必要步骤——否则插件连加载机会都没有。
