VS Code不内置模拟器，调试UI的关键是确保flutter run能连上设备并支持热重载；需先运行flutter doctor -v检查环境，启动模拟器后在VS Code中按F5以调试模式启动。
VS Code 本身不内置模拟器，必须依赖系统级的 Android/iOS 模拟环境；调试 UI 的核心不是“启动模拟器”，而是确保 flutter run 能连上设备、热重载（Ctrl+S 或 F5）能实时反映 UI 变化。
确认 Flutter 环境与设备列表是否就绪
这是所有后续操作的前提。VS Code 只是编辑器，真正驱动模拟器和构建的是 Flutter CLI。
- 在终端运行
flutter doctor -v，重点检查：Android toolchain（含Android SDK、AVD Manager）、Chrome（用于 web）、Connected device是否显示可用设备（如emulator-5554或iPhone 15） - 若
Connected device为空，说明模拟器没启动，或 iOS 没连上 Xcode 设备服务；Android 需手动启动 AVD（通过Android Studio → AVD Manager），iOS 需打开Xcode → Window → Devices and Simulators并确保模拟器已运行 - VS Code 中按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（Mac），输入Flutter: Select Device，确认列表里有目标设备；没有则说明flutter devices命令也查不到它
在 VS Code 中启动调试会话（F5）而非手动 run
直接终端敲 flutter run 无法触发 VS Code 的断点、变量监视和热重载快捷键；必须用调试模式启动。
jm-jsjkxyjs02-zlm-405
下载
使用约定式提交（Conventional Commits）生成标准化的 Git 提交信息。适用于以下场景： (1) 暂存更改时需要提交信息； (2) 审查 diff 时希望获得结构化摘要； (3) 编写 PR 描述或变更日志（changelog）条目； (4) 用户明确要求“为本次更改编写提交信息”。 该功能会分析已暂存/未暂存的 diff，并生成按类型（type）划分范围的提交信息。
- 确保项目根目录下有
lib/main.dart，且已配置好 launch 配置：VS Code 会在首次按F5时自动创建.vscode/launch.json - 生成的默认配置通常为：
{ "version": "0.2.0", "configurations": [ { "name": "Flutter", "request": "launch", "type": "dart" } ] }无需修改即可使用 - 按
F5启动后，VS Code 底部状态栏会显示设备名、当前运行模式（debug）、热重载按钮（⚡）；此时修改lib/main.dart并保存（Ctrl+S），UI 即刻更新——这才是调试 UI 的正确节奏 - 若按
F5报错 “No device found”，不是 VS Code 问题，而是flutter devices返回空，需回退到上一步排查模拟器或连接
常见 UI 调试卡点与绕过方式
热重载失败、UI 不刷新、断点不命中，90% 和设备状态或代码结构有关，和 VS Code 设置关系极小。
-
setState外部调用无效？确保你是在StatefulWidget的State类中调用，且该 widget 正在 build 树中；热重载不会重建整个 widget 树，只更新可变部分 - 修改颜色/文本后无变化？检查是否误改了未被引用的 widget（比如在
Column里加了个新Text，但忘了把它加进children列表） - 断点灰色不可用？说明 Dart VM 尚未加载该文件，或该行不是可执行语句（如类声明、空行、注释）；尝试在
build()方法第一行或initState()中设断点 - 想快速预览 Widget？右键点击 widget 名称（如
Text），选择Flutter: Inspect Widget，它会高亮渲染区域并显示 widget 树层级
最易被忽略的一点：模拟器窗口最小化或失去焦点时，某些 Android AVD 会暂停渲染甚至断开调试连接；保持模拟器窗口可见、前台运行，才能稳定响应热重载和断点。
