简介：面向舞台、剧院、电视台及影院灯光从业者与学习者的 grandMA 2 中文详细手册教程，针对专业控台术语密集、英文资料查阅不便的问题，提供一套成体系的中文参考。压缩包内为 1 个 PDF 文件，大小约 37.92MB，篇幅达 1700 多页，章节编号清晰，适合在电脑或平板上按目录检索。内容覆盖系统要求与软件安装、控台及回放单元/推子翼/onPC 控制翼等设备概述、安全信息，以及脱机系统和网络系统等模块，并补充编程语言与设备支持等新增内容。已有 5722 人学习，可作为日常排错、培训备课和现场操作的案头查询资料。读者可据此快速定位概念，理解设备连接、系统架构与安全规范，减少因术语和流程不熟造成的操作障碍，也便于把分散知识点串联成完整学习路径。
1. 1700 页不是拿来通读的，是拿来定位的
第一次翻开这份 grandMA2 控台中文手册，多数人会被目录劝退：从“手册新增内容”开始，接着是安全符号、设备概述、系统概述，光第 7 章“按键和按钮”就一路排到几十个小节，一个 [Assign] 键能写两页半，一个 [At] 键能扯出百分比、绝对值、预设引用三种输入方式。它压根不是一本从第一页读到最后一页的教程，而是一本按功能索引的参考册——灯光控台的系统拓扑、onPC 与实体台面的差异、网络会话、参数扩展、命令行语法、每个键的边界行为，全塞在里面，但没有人告诉你先看哪一章。
这份资源真正解决的问题是：不想在演出前抱着英文原版翻，又需要一个能对得上按键位置的中文答案。适合三类人——刚上台面、连 Fixture 和 Channel 都分不清的新手；从其他控台迁移过来、需要快速对齐术语的老灯光师；以及要给团队做内部培训、需要一份统一口径教材的人。下面按我自己拆这份手册的顺序讲，从系统形态一路落到配接、命令行和现场排错。
2. 拆开这套系统：台面、NPU 与 onPC 到底怎么选
2.1 手册的骨架不是章节顺序，是四层信息
把目录摊平看，这 1700 多页其实是四层叠起来的，每层的读法完全不同。
第一层是第 1 到第 3 章，版本新增内容加安全信息。安全那章常被当成免责声明跳过，实际上“符号使用”“预期用途”“电流引起的危险”“一般安全说明”这四节，是现成的上岗须知，做团队培训时可以直接照着讲，比你自己编一套规范省事。第二层是第 4、5 章，设备概述和系统概述，这是选型章：4.1 到 4.5 把控台、回放单元（RPU）、推子翼、onPC 控制翼、onPC 推子翼分开讲清楚，5.1 到 5.6 讲脱机系统、网络系统，以及 RPU、NPU、VPU、NDP、MA 3D、MA Node 这几个听起来像黑匣子的东西各自负责什么，最后落到参数与 DMX 通道、参数扩展、大型系统、中型网络和 CIPT。第三层是第 6 章“第一步”，纯物理动作：开箱、检查交货清单、安装、接电、接台灯、接外屏、接 USB 键鼠、接 DMX、接声音、接 SMPTE（LTC）、接以太网、接模拟遥控器、接推子翼、设置电脑、第一次开机。第四层才是第 7 章往后的按键逐条解释和各功能模块。
我一般建议的阅读路径是：先啃 5.1 到 5.3 把“参数”这个概念立住，再翻第 6 章照着线一根根插，然后看 7.1 键概述建立全局图，最后才是按需查具体键。反过来从第 7 章开始读，会在 [GoFastForward] 和 [GoFastBack] 这种冷门键上耗掉半天，还没摸到控台。
2.2 单机脱机、网络会话、参数扩展：三种形态的边界
手册 5.1 讲的脱机系统，指的是 onPC 软件单独跑在一台 Windows 机器上，不接任何硬件。这是最容易被低估的形态：编曲、排 Cue、练手、给客户做离线预演，全靠它。局限也明显——没有物理推子和按键，执行器操作只能靠屏幕点，手感和上台面完全是两回事。
5.2 讲的网络系统是另一回事。多台设备加入同一个 session，一台做主控，其余做从机或热备，走以太网。这里的门槛不在操作，在三个一致性：网段一致、软件版本一致、session 设置一致。少一个，屏幕上就是只剩本机在线，你在主控上改的东西从机完全看不见。5.2.1 到 5.2.6 分别解释 RPU、NPU、VPU、NDP、MA 3D、MA Node 的定位，说白了就是一句话：台面自带的处理能力不够时，用这些盒子往外扩。
最需要提前想清楚的是 5.3 和 5.4 这一对——参数与 DMX 通道、参数扩展。一个 Universe 是 512 个 DMX 通道，这是死的；但“参数”是控台内部对灯具属性的计数，一台摇头灯在 16 位模式下可能吃掉二三十个 DMX 通道，在控台上却只算一组参数。很多人买设备时按 Universe 数量倒推，结果参数先爆了。手册把这两件事拆成两节写，就是因为现场最容易在这里翻车。选型时的正确姿势是：先列出所有灯具型号和数量，算出总参数，再去对照手册里的参数表，看台面够不够、要不要加 NPU。
2.3 装机：系统要求核对与 onPC 安装的落地步骤
手册第 2 章给的系统要求是当年版本的下限：Intel Core 2 Duo 或更高处理器、4GB 以上内存、NVIDIA GeForce 9600 GT 或更高显卡、DirectX 9.0c 或更高，跑在 Windows 上。放在今天，随便一台办公本都过线，所以真正的坑不在这些数字上。
| 核对项 | 手册标注 | 实操建议 |
|---|---|---|
| 处理器 | Core 2 Duo 或更高 | 双核够跑，但多屏加 3D 预演建议四核以上 |
| 内存 | 4GB 以上 | 开 MA 3D 同跑时 8GB 起步，16GB 更稳 |
| 显卡 | GeForce 9600 GT 或更高 | 独显优先，双显卡笔记本要强制指定独显 |
| DirectX | 9.0c 或更高 | 装完系统组件后重启一次再装软件 |
| 屏幕分辨率 | 手册未强调 | 台面软件对分辨率敏感，1366×768 会挤掉面板 |
| 安装路径 | 无特殊要求 | 不要放中文路径，也不要放桌面同步目录 |
安装步骤我一般按这个顺序走，每一步都别省：
- 临时关掉杀毒软件的实时防护，装完再开回来。
- 右键安装包，选“以管理员身份运行”，避免写注册表失败。
- 安装路径改成纯英文，例如
D:\grandMA2_onPC\。 - 装完重启一次，别直接双击图标。
- 首次启动选语言，进主界面后先看标题栏或 About 里的版本号，抄下来。
- 新建一个空 show，随便存一次盘，确认有写权限。
- 把版本号发给同组的人，要求大家装同一个版本。
提示：onPC 和实体台面的版本号必须一致，哪怕只差一个小版本，show 文件也可能打不开或者行为异常。装完第一件事不是配接，是对版本号。
3. 命令行才是主线：上百个按键其实是一套语法
3.1 按键分区：为什么第 7 章按字母序讲键没法读
第 7 章从>>> [GoFastForward]开始，一路按字母排到 [Zoom]，中间还夹着 [.]、[Align]、[Assign]、[At]、[Backg]、[Backup]、[Blind]、[Bt Pg+]、[B.O.]、[Channel]、[Clear]、[Copy]、[Cue]、[Del]、[Down]、[Edit]、[Effect]、[Encoder]、[Esc]、[Exec]、[Fd Pg+]、[Fix]、[Fixture]、[Freeze]、[Full]、[Go+]、[Goto]、[Group]、[Help]、[Highlt]、[If]、[Keyboard]、[Learn]、[List]、[MA]、[Macro]、[Minus]、[Mouse]、[Move]、[Next]。这种排法对查字典很友好，对学习极不友好。
实际台面上的键分五个区，按区分组记，比按字母背快十倍：
| 分区 | 代表键 | 干什么用 |
|---|---|---|
| 命令区 | Store、Clear、Please、Assign、Copy、Move、Delete、Label、Update、Off、On | 决定“做什么动作” |
| 选择区 | Fixture、Channel、Group、Page、Next、Prev、All | 决定“对谁做” |
| 数值区 | 0-9、At、Full、Thru、Minus、Dot | 决定“做成多少” |
| 执行区 | Go+、Go-、Goto、Pause、Blackout、Freeze | 演出中推进 Cue |
| 功能键 | Setup、Tools、Backup、Help、Effect、Macro、Time、Executor、If、Blind、Highlight | 进菜单、开特殊模式 |
[Please] 是这套键盘里最特殊的一个键，它等价于回车——命令行敲完不按它，什么都不会发生。新手最常见的困惑就是“我明明输了命令怎么没反应”，八成是忘了按 [Please]。
3.2 三段式命令：对象、属性、值
手册第 7 章每个键单独讲，但把命令行拆开看，绝大多数命令都是同一个骨架：对象 + 属性 + 值，最后用 [Please] 执行。
Fixture 1 Thru 10 At 50 Please这条命令里，Fixture 1 Thru 10是对象，At是属性入口（不写具体属性时默认指向 Dimmer），50是值，单位是百分比。Thru表示范围，也可以用+追加、-剔除，例如Fixture 1 Thru 10 - 5。
再看几条日常使用频率最高的：
Group 3 At Preset 4.1 Please # 把 3 号编组整体调到 4 号池第 1 个预设 Copy Cue 5 At Cue 10 Please # 复制 5 号 Cue 到 10 号位置 Label Cue 10 "开场黑" Please # 给 10 号 Cue 改名，中文要加引号 Store Cue 11 Please # 把当前编程器内容存成 11 号 Cue Clear # 清空命令行，不影响已存内容 Clear Clear # 连按两次，清空编程器里的临时值参数说明几个容易混的点。At后面跟纯数字是百分比，跟Full是 100%，跟Preset x.y是引用预设池；Store存的是编程器当前状态，不是屏幕显示；Clear一次只清命令行，编程器里那些没存的值还在，要连按两次才清干净。很多人排完一场发现灯莫名其妙亮着，就是编程器没清。
3.3 宏与命令行补全：把重复动作压成一行
宏（Macro）在手册里是单独一章，本质就是把一串命令行按顺序存起来，用一条命令触发。现场最典型的场景是“每天开场前把所有灯归零、清编程器、存一个备用 Cue”，这套动作手点要二十秒，写成宏只要一下。
Macro 5 1 Clear 2 Fixture 1 Thru 10 At 0 Please 3 Clear Clear在 Macro 编辑器里逐行填，行号就是Macro 5.1、5.2这样的子项，执行时敲Macro 5 Please。行号可以留空跳步，也可以在某一行插Time控制渐变速度：
Macro 6 1 Clear 2 Channel 1 Thru 12 At Full Please 3 Store Cue 20 Time 3 Please第 3 行的Time 3表示存进去的 Cue 自带 3 秒渐变，省掉事后单独改时间的步骤。
注意：宏里慎用
Clear Clear。如果你的宏是在排练中途触发的，双击 Clear 会把编程器里还没存的修改一起清掉，这个后悔药没地方买。我一般在宏里只用单次Clear，双清留给专门的收工宏。
命令行的另一个价值是可复制。你在台面上调好一段效果，把命令行截图发给同事，对方照着敲就能复现，比口头描述“先选灯再点那个什么”靠谱得多。手册第 7 章每个键下面都会列出对应的命令写法，这一部分才是真正值得反复翻的内容。
4. 从零到第一个 Cue：配接、编组、预设的落地链路
4.1 配接先算账：Universe、地址与负载
配接（Patch）是整场演出的地基，出问题最难查。动手之前先在纸上或者表格里把账算清楚：每台灯的 DMX 通道数、起始地址、落在哪个 Universe、一条链上挂了多少台。
| 灯具 | 数量 | 模式 | 单台通道数 | Universe | 起始地址 | 结束地址 |
|---|---|---|---|---|---|---|
| 摇头图案灯 | 8 | 16 位 | 28 | 1 | 1 | 224 |
| LED 染色灯 | 12 | 标准 | 12 | 1 | 225 | 368 |
| 频闪 | 6 | 基础 | 4 | 1 | 369 | 392 |
规则只有三条，但违反任何一条都会在演出里出问题：一个 Universe 最多 512 个通道，地址不能重叠，一条 DMX 链建议不超过 32 台设备。手工排到二三十台就开始出错，我一般用脚本先生成，再人工核一遍。
# 按灯具清单顺序分配 DMX 地址，自动跨 Universe UNIVERSE_SIZE = 512 def allocate(fixtures, start_universe=1, start_addr=1): """fixtures: [{'name':..., 'qty':..., 'channels':...}, ...]""" plan, uni, addr = [], start_universe, start_addr for f in fixtures: for i in range(f["qty"]): need = f["channels"] # 当前 Universe 放不下就跳到下一个 if addr + need - 1 > UNIVERSE_SIZE: uni += 1 addr = 1 plan.append({ "name": f"{f['name']}-{i + 1}", "universe": uni, "start": addr, "end": addr + need - 1, }) addr += need return plan fixtures = [ {"name": "摇头图案灯", "qty": 8, "channels": 28}, {"name": "LED染色灯", "qty": 12, "channels": 12}, {"name": "频闪", "qty": 6, "channels": 4}, ] for row in allocate(fixtures): print(f"{row['name']}\tU{row['universe']}\t{row['start']}-{row['end']}")这段脚本只做一件事：按你给的顺序往后累加，遇到 512 边界自动换 Universe，输出一张可以直接照着录进 Patch 表的清单。UNIVERSE_SIZE是硬约束，别改；start_universe和start_addr留给你从中间接续已有系统的情况。真正上控台前，把输出结果和实际灯位再对一遍，尤其是那些“同一型号但模式不一样”的灯，通道数不同，脚本不会替你发现。
4.2 编组与预设池：把临时选灯变成可复用资产
配接完之后，最省时间的动作是编组。选好一批灯，Store Group 1 Please，再Label Group 1 "面光" Please，以后敲Group 1就能整组选中。编组的好处是，现场加灯减灯只要改编组成员，后面所有引用它的地方自动跟着变。
预设池（Preset Pool）是第二层复用。默认模板里，1 号池一般是 Dimmer，2 号池是 Position，4 号池是 Color，5 号池是 Beam，但不同 show 模板可能被改过，动手前先看池子左侧的类型标签，别凭记忆敲。
Fixture 1 Thru 8 At 50 Please # 先给个亮度 Store Preset 1.1 Please # 存进 Dimmer 池第 1 个 Fixture 1 Thru 8 At Preset 1.1 Please # 之后直接引用提示：预设是引用关系，不是快照。你改了
Preset 4.1的颜色，所有引用它的 Cue 全部跟着变。这是效率来源，也是事故来源。要单点改、不影响别处，存 Cue 时选Cue Only。
4.3 存 Cue、分配执行器与 Tracking 的边界
存 Cue 本身只有一条命令，难的是理解 Tracking 逻辑。默认模式下，控台是跟踪的：你在 Cue 5 给某个灯设了 50% 亮度，这个值会一直带到 Cue 6、7、8，直到某个 Cue 显式改了它。所以修改中间某个 Cue，很可能把后面一串 Cue 的表现全改了。
Store Cue 1 Please Store Cue 2 Time 3 Please # 2 号 Cue，3 秒渐变 Assign Sequence 1 At Executor 1.1 # 把序列挂到 1 号推子第 1 页 Block Cue 5 Please # 把 5 号 Cue 的值锁死，不再跟踪前值Block是演出前必用的自保手段：在关键节点把值钉住，后面怎么改前面都不会串过来。用Cue Only存则是另一种思路——只改这一个 Cue，把变化“挡”在这里，不影响下一个 Cue。这两个工具的区别，手册里分散在好几节，实际排一场下来才能体会。
执行器分配这块，我的习惯是固定一套模板：1 到 10 号推子放场景，11 到 20 号放效果，21 号以上留手动。模板固定下来，换场地换台面，肌肉记忆不用重建。
5. 常见问题排查：五个现场翻车点
5.1 会话里只有本机在线
现象：两台设备都插了网线，屏幕上自己在线，对方死活不出现，ping 得通但 session 列表里就是没有。
原因基本跑不出三个：两台机器不在同一网段，或者子网掩码不一致；机器有多张网卡（有线加无线），软件走错了一张；两边软件版本差了一个小版本号，协议对不上。
解决顺序是先把无线网卡禁用，只留有线；然后核对 IP 和掩码，手写成同一网段；最后对版本号。三样都对还连不上，换一根网线试试，劣质线在长距离下丢包，表现和配置错误一模一样。
5.2 地址和配接都对，灯就是不亮
现象：Patch 表抄了三遍，地址核对无误，灯具菜单里模式也选了，推上去就是不亮。
原因往往不在控台，在物理层。DMX 线序接反、接头氧化、一条链挂了超过 32 台、末端没加终端电阻，都会让信号衰减到灯具认不出来。还有一种更隐蔽的：台面上的 DMX 输出口编号和 Universe 编号不是一一对应的，你以为插的是 Universe 1，实际输出到了别的口。
解决：先拿一台灯单独接最短的线试，排除灯具本身；再逐段加长、加负载，找到断点；最后进 Setup 里核对输出口映射，别信机身上印的标签。
5.3 版本差一位，show 文件直接打不开
现象：在自己机器上存的 show，拷到现场台面上打不开，或者打开后部分功能报错。
原因是大版本之间的 show 文件格式不向下兼容，小版本之间也可能有行为差异。控台不会提示“版本不匹配”，只会给你一个打不开或者打开后行为诡异的文件。
解决：出发前把所有要用的设备版本号统一，抄在一张纸上贴箱子；现场如果对方版本更高，先在你的机器上升级再存；实在打不开，让对方用高版本打开后另存一份低版本兼容格式，别硬试。
5.4 U 盘备份回到现场少了一半
现象：演出前做了备份，回到现场恢复，发现 show 在，但灯具库、用户配置、宏全没了。
原因是只拷了 show 文件，没做完整备份。show 文件不包含灯具库和用户配置，这些是独立存的。
解决：一律走 Backup 菜单做完整备份，不要直接进文件管理器拖文件夹；U 盘格式用 FAT32，别用 NTFS 或者 exFAT，部分台面对后两者识别不稳定；备份完当场在另一台设备上恢复一次验证，这一步别省。
5.5 中文术语搜不到对应功能
现象：想查 Executor 怎么配，搜“执行器”搜不到；想查 Preset，搜“预设”出来的页面和你想的不是一回事。
原因是中文手册的译法不统一：Executor 译成执行器，Preset 译成预设，Sequence 译成序列，但 Cue、Fader、Executor 这些词在很多段落里又保留了英文原文。同一份文档里两种写法混着用。
解决：自己维护一张中英对照表，左边写中文译名，右边写英文原名和手册页码。搜的时候两个词都搜一遍。这张表做一次，后面几年都能用。
6. 进阶：把 1700 页压成 20 页自己的速查表
6.1 三列索引法
手册的正确用法不是读，是查。我自己的做法是维护一张三列表格，只记“我要干什么”“命令行怎么写”“手册哪一章”，别的全不记。
| 我要做什么 | 命令行 | 手册位置 |
|---|---|---|
| 选一批灯 | Fixture 1 Thru 10 Please | 第 7 章 Fixture 键 |
| 整组调亮度 | Group 1 At 50 Please | 第 7 章 Group 键 |
| 存一个场景 | Store Cue 1 Please | Cue 与序列章 |
| 改 Cue 名 | Label Cue 1 "名字" Please | Label 键 |
| 复制 Cue | Copy Cue 5 At Cue 10 Please | Copy 键 |
| 断开跟踪 | Block Cue 5 Please | Tracking 相关节 |
| 清编程器 | Clear Clear | Clear 键 |
| 完整备份 | Setup → Backup | 第 6 章备份节 |
这张表填到二十行左右就够用了，覆盖现场九成动作。剩下的冷门功能，等真用到了再往表里加一行。
6.2 上台前的十分钟验证清单
每次进场我都会走一遍固定流程，十分钟，顺序不能乱：开机看版本号是否一致、进 session 确认所有设备在线、开一个空 show 试存盘、抽三台灯手动推一下确认物理通路、跑一遍开场 Cue 看有没有跳变、按一次 Blackout 再恢复、做一次完整备份并换机恢复验证、清编程器、把宏列表过一眼确认没被改过、最后把推子归零。
这套清单是踩出来的。有一回省了“换机恢复验证”那一步，现场恢复时发现 U 盘里只有 show 没有灯具库，三十多台灯的属性全丢，只能靠记忆现配，开场推迟了四十分钟。从那以后我每次备份都强制走一遍异机恢复，哪怕时间再紧也不跳。这套顺序看着啰嗦，真出问题时能把你从台上捞回来。希望帮到你。
本文还有配套的精品资源，点击获取
