单独打开 11-editor-tour,等待索引和 CLI 依赖同步。快捷键使用 IDEA 默认 Windows/Linux 键位,也可从菜单执行。VS Code 提供同源 LSP 的编辑能力;原生 DSB 运行菜单属于 IDEA。
| 操作 | 步骤 | 预期结果 |
|---|---|---|
| 悬停文档 | 在 Mission/reward 上悬停,Task.total 按 Ctrl+Q | 显示文档、参数和返回值 |
| 定义导航 | Mission 按 Ctrl+B,依次跳转 reward 和 Task.total | 跨文件定位,别名解析为 Task |
| 参数提示 | 测试文件中的 Task.new( 内 Ctrl+P | name、points 参数 |
| 成员补全 | mission 后输入点并 Ctrl+Space | name、points、bonus、total |
| 查找用法 | Task/reward 上 Alt+F7 | 跨文件和测试引用 |
| 重命名 | Task 上 Shift+F6,改为 Quest,查看预览 | 导入与类型引用同步;练习后撤销 |
| 符号与层次 | Task 查看 Type Hierarchy;reward 查看 Call Hierarchy;打开 Structure | NamedTask 继承关系、调用者和文件符号 |
| 格式化 | 改动空格后 Reformat Code;选择一段后再格式化 | 文档/范围格式化 |
| 导入优化 | 重复一个 import 后 Optimize Imports | 清理重复项,保留注释/版本分隔 |
| 导入快速修复 | 临时删除 services/rewards.mcfpp 的 Task import | 未解析引用;Alt+Enter 提供导入修复 |
| 创建声明 | 临时调用 missingHelper(1),按 Alt+Enter | 提供创建函数意图;练习后删掉临时调用 |
| 类型诊断 | 暂将 reward(mission) 改为 reward(1) | 报告类型不匹配;恢复后消失 |
| 推断提示 | 开启 Inlay Hints,观察 mission/result | 推断类型与参数名 |
| 文档导出 | 执行 mcfpp doc --format both | build/docs 中的 HTML 与 JSON |
01 展示版本指令;04 展示命令补全、选择器与插值;08 展示原版 .mcfunction 和按路径匹配的 JSON Schema;10 展示 Kotlin MNI 绑定与注解类型字符串。编号工程默认保持可编译,故意制造的错误在练习后恢复。
工具窗口可同步依赖并执行 Build、Test、Check、Dump IR。09 在 recurse 调用处断点后选择 Debug,尝试 Step Into/Over/Out 和 payload.values[1] Watch。07 使用 Run (Render)/Test (Render),体验播放、单 tick、相机、重置、PNG 导出。
CLI 验证与实际 IDE 交互的验证范围分别记录于 verification.md。