VSCode插件不支持真正的多层嵌套菜单，menus配置仅允许一级子项；所谓“二级菜单”是通过group分组、命名约定及QuickPick模拟的视觉效果，并非真实父子结构。
VSCode 插件开发中不支持“多层嵌套菜单”——package.json 的 menus 配置只允许一级子项，所谓“二级菜单”是假象，实际是快捷方式或命令面板入口的视觉模拟。
为什么 menu contribution 无法定义二级下拉菜单
VSCode 的贡献点（contribution point）设计明确限制了菜单层级：menu 字段只接受字符串数组（如 ["editor/context"]），而其 submenu 属性在官方 schema 中并不存在。你看到的“嵌套菜单”，比如右键里出现“Format → Prettier → Format with Prettier”，其实是三个独立条目，靠命名和分组逻辑模拟层级，而非真实父子结构。
- 所有菜单项最终都注册到同一级 context menu 或 command palette 中
- VSCode 不解析
title里的斜杠（"Format/Prettier"）为嵌套，只是原样显示文本 - 尝试在
menus中写"submenu": "prettier"会导致插件激活失败或被忽略
如何用 group 和 order 模拟“嵌套感”
真正可控的是排序与分组。VSCode 允许通过 group 字符串控制显示顺序和视觉分隔，格式为 category@order，其中 @ 后的数字决定先后（越小越靠前）。
-
"group": "navigation"→ 放在顶部区域 -
"group": "1_modification"→ 放在编辑区修改类操作附近 -
"group": "prettier/0_format"→ 在右键中创建名为 “prettier” 的分组，0_format表示该组内第一个项 - 多个同
group值的项会连续排列，并自动加分割线（除非显式设"when"条件干扰）
例如，想让“Prettier: Format”和“Prettier: Ignore”看起来属于同一功能块，就都设 "group": "prettier/1" 和 "group": "prettier/2"，VSCode 会把它们收拢在一起。
command palette 中的“伪嵌套”命名陷阱
用户常在 commands 里写 "title": "Prettier: Format"，以为冒号能触发分组，但 VSCode 并不解析它。真正起作用的是 command ID 和 when 上下文条件：
-
"command": "prettier.format"和"command": "prettier.ignore"是两个完全独立的命令 ID - 若希望只在 .ts 文件中显示某条命令，必须配
"when": "resourceLangId == 'typescript'" - 命令面板搜索时，输入 “prettier format” 能命中，是因为全文匹配标题，不是因为结构嵌套
别依赖标题里的符号做逻辑分组——那只是给用户看的提示，后端无感知。
替代方案：用 QuickPick + 多级选项模拟嵌套交互
如果真需要多级选择（比如先选项目、再选环境、最后执行部署），不能靠菜单，得用 vscode.window.showQuickPick() 手动构建流程：
- 第一级 QuickPick 列出所有项目名，用户选中后触发第二级
- 第二级基于第一级结果动态加载环境列表
- 每级都可带
description和detail，比菜单更灵活 - 注意避免阻塞主线程：异步加载选项，加
loading状态提示
这种模式虽然代码量稍增，但体验更可控，也符合 VSCode 对“轻量交互”的设计哲学——菜单只负责快捷触发，复杂流程交给专用 UI。
最易被忽略的一点：VSCode 从不缓存菜单结构。每次右键展开，都会重新评估 when 条件、重新读取 package.json 中的 menus 配置。这意味着动态菜单（比如根据当前 workspace 是否含 prettier.config.js 决定是否显示某项）必须靠 when 表达式实现，而不是在插件激活时“注册一次”。
