第2章 MenuItem与菜单系统

2. MenuItem与菜单系统：MenuItem属性详解、菜单路径、快捷键、菜单有效性验证

好，咱们今天来聊聊编辑器扩展里最基础、也最常用的东西——MenuItem。

说实话，我刚开始学Unity编辑器扩展时，第一个接触的就是它。你想想看，能在编辑器顶部菜单栏里加一个自己的按钮，点一下就能执行一段代码，这感觉多爽。但用久了你会发现，MenuItem其实藏着不少细节。今天我就把这些年踩过的坑、积累的经验，一次性讲清楚。

2.1 MenuItem属性基础

MenuItem是一个C#属性，你把它挂在静态方法上，Unity就会在菜单栏里生成对应的菜单项。用法很简单：

[MenuItem("Tools/我的工具")]
static void MyTool()
{
    Debug.Log("点了我！");
}

嗯，就这么几行代码，你就能在Unity顶部菜单栏看到"Tools"下多了一个"我的工具"。点一下，控制台就会输出日志。

但这里有个关键点——方法必须是静态的。为什么？因为Unity在加载编辑器时就会扫描所有带MenuItem特性的方法，然后注册到菜单系统里。非静态方法没法在没实例的情况下调用，所以Unity直接不支持。

核心要点：

MenuItem只能挂在静态方法上
方法可以是public或private，都能正常工作
一个方法可以挂多个MenuItem，生成多个菜单项

2.2 菜单路径的命名规则

菜单路径说白了就是用斜杠分隔的字符串。比如"GameObject/3D Object/Cube"，这就是Unity内置菜单的写法。

我个人习惯把自定义工具放在"Tools/你的工具名"下面。当然你也可以放在"Window/"、"Assets/"甚至"GameObject/"下面。但要注意——不要和Unity内置菜单重名，否则会覆盖掉。

我记得有一次，我想加一个"Create/Cube"的菜单项，结果发现Unity自带的Cube菜单不见了。排查了半天才发现，我的路径和内置的完全一样，直接覆盖了。嗯，这是个坑。

避坑指南：

我曾经因为路径写错，导致整个菜单层级混乱。比如"Tools//我的工具"多了一个斜杠，Unity会把它当成空文件夹名，显示出来就是"Tools > > 我的工具"，特别难看。所以写路径时一定要检查斜杠的位置。

2.3 快捷键绑定

MenuItem支持快捷键，格式是在路径后面加空格，然后写快捷键组合。比如：

[MenuItem("Tools/我的工具 &T")]
static void MyTool()
{
    // Alt + T
}

[MenuItem("Tools/我的工具 %T")]
static void MyTool2()
{
    // Ctrl + T (Windows) / Cmd + T (Mac)
}

[MenuItem("Tools/我的工具 #T")]
static void MyTool3()
{
    // Shift + T
}

[MenuItem("Tools/我的工具 %#T")]
static void MyTool4()
{
    // Ctrl + Shift + T
}

符号对应关系：

符号	含义	说明
%	Ctrl (Windows) / Cmd (Mac)	最常用
#	Shift	配合其他键使用
&	Alt	注意不是Shift+7那个符号
_	无修饰键	比如 _T 就是直接按T

你想想看，如果给常用工具绑个快捷键，开发效率能提升不少。我自己的习惯是：调试工具用Ctrl+Shift+字母，日常工具用Alt+字母。这样不容易和Unity内置快捷键冲突。

小技巧：

快捷键字母不区分大小写。但建议用大写字母，因为菜单里显示的是大写，看起来更统一。

2.4 菜单有效性验证

这个功能我觉得特别实用。有时候你希望菜单项只在特定条件下才可用，比如选中了某个类型的物体时才能点击。

做法很简单：写两个方法，一个带MenuItem，另一个带MenuItem的验证参数。

[MenuItem("Tools/处理选中物体")]
static void ProcessSelected()
{
    // 处理逻辑
    Debug.Log("处理了：" + Selection.activeObject.name);
}

[MenuItem("Tools/处理选中物体", true)]  // 第二个参数为true表示验证方法
static bool ValidateProcessSelected()
{
    // 返回true时菜单可用，false时禁用
    return Selection.activeObject != null;
}

注意看，验证方法的名字和主方法一样，只是多了一个true参数。返回值是bool，true表示菜单可用，false表示禁用。

我在项目中遇到过这样一个场景：我们有个批量处理材质的工具，要求必须选中至少一个材质球才能用。如果没有验证，用户点了没反应，就会觉得工具坏了。加了验证后，菜单直接变灰，用户一看就知道「哦，要先选东西」。

验证方法的规则：

方法名必须和主方法相同
MenuItem的第二个参数传true
返回值必须是bool
参数列表必须为空

2.5 优先级控制

你有没有发现，菜单项的顺序有时候很随机？其实Unity是按照字母顺序排列的，但你可以通过优先级来控制。

MenuItem的第三个参数就是优先级，数字越小越靠前。默认是1000。

[MenuItem("Tools/我的工具", false, 1)]  // 排在最前面
[MenuItem("Tools/另一个工具", false, 2)] // 排在第二个
[MenuItem("Tools/默认工具")]              // 优先级1000，排在后面

优先级还有一个隐藏功能：在优先级相差11以上的菜单项之间，Unity会自动插入分隔线。比如优先级1和优先级12之间就会有一条横线。

嗯，这个细节我当初也是翻文档才发现的。后来做工具集时，我就用这个特性来分组，比如1-10是一组，20-30是另一组，中间自然就有分隔线了。

2.6 菜单项的其他玩法

除了上面这些，MenuItem还有一些不太常见但很实用的用法。

1. 添加已有菜单项

你可以给Unity内置菜单添加功能，比如在"GameObject"菜单下加一个自定义项：

[MenuItem("GameObject/我的自定义物体", false, 10)]
static void CreateMyObject()
{
    new GameObject("我的物体");
}

2. 右键菜单

在Project窗口或Hierarchy窗口的右键菜单里加项：

[MenuItem("Assets/我的资源工具")]
static void AssetTool()
{
    // 在Project窗口右键时出现
}

[MenuItem("GameObject/我的游戏对象工具", false, 0)]
static void GameObjectTool()
{
    // 在Hierarchy窗口右键时出现
}

3. 上下文菜单

这个稍微特殊一点，是用CONTEXT前缀：

[MenuItem("CONTEXT/Transform/重置位置")]
static void ResetPosition(MenuCommand command)
{
    Transform transform = (Transform)command.context;
    transform.position = Vector3.zero;
}

这样你在Inspector窗口里右键Transform组件时，就会多出一个"重置位置"的选项。

个人经验：

我经常用CONTEXT菜单给常用组件加快捷操作。比如给Camera加一个"切换正交/透视"，给Light加一个"切换阴影"等等。这些操作虽然小，但每天用几十次，累积下来能省不少时间。

2.7 实战：做一个完整的工具菜单

说了这么多，咱们来整合一下。假设我要做一个场景管理工具，包含以下功能：

保存当前场景快照
加载快照（需要先有快照才能用）
清除所有快照（需要确认）

代码大概是这样的：

public static class SceneSnapshotTool
{
    private static string snapshotPath = "Assets/SceneSnapshot.asset";

    [MenuItem("Tools/场景快照/保存快照 %&S")]
    static void SaveSnapshot()
    {
        // 保存逻辑
        Debug.Log("快照已保存到：" + snapshotPath);
    }

    [MenuItem("Tools/场景快照/加载快照 %&L", true)]
    static bool ValidateLoadSnapshot()
    {
        return System.IO.File.Exists(snapshotPath);
    }

    [MenuItem("Tools/场景快照/加载快照 %&L")]
    static void LoadSnapshot()
    {
        // 加载逻辑
        Debug.Log("快照已加载");
    }

    [MenuItem("Tools/场景快照/清除快照")]
    static void ClearSnapshot()
    {
        if (EditorUtility.DisplayDialog("确认", "确定要清除快照吗？", "确定", "取消"))
        {
            // 清除逻辑
            Debug.Log("快照已清除");
        }
    }
}

你看，这里用到了快捷键、验证、对话框确认。一个完整的工具菜单就出来了。

最后说一句，MenuItem虽然简单，但它是编辑器扩展的基石。把这块吃透了，后面学Window、Editor、PropertyDrawer都会轻松很多。

下一章咱们聊聊更高级的——如何用EditorWindow创建完整的工具窗口。到时候你会发现，菜单只是入口，真正的战场在窗口里。