4. 迁移前环境准备
项目程序迁移失败，十有八九不是迁移动作本身出错，而是迁移前的环境没对齐。ROBOGUIDE 的版本、控制器的软件版本、选项授权（Option）以及工作单元（Workcell）的复制方式，这四件事只要有一件不匹配，后续的导入、编译、仿真就会在莫名其妙的地方报错。本节把这四项准备工作拆开讲清楚，并给出可执行的判断依据。
一、ROBOGUIDE 版本选择：先看控制器，再定软件
ROBOGUIDE 的版本选择原则是“向下兼容、向上受限”。ROBOGUIDE 只能仿真等于或低于其内置控制器版本的机器人系统，不能仿真比它更新的控制器版本。因此正确顺序是：先确认现场机器人控制器的软件版本（如 V9.30、V9.40），再选择不低于该版本、且能覆盖该版本的 ROBOGUIDE 版本。
例如现场控制器为 R-30iB Plus，系统软件 V9.30，那么应选择 ROBOGUIDE V9.30 或更高（如 V9.40）。若用 V9.10 的 ROBOGUIDE 去打开 V9.30 的备份，控制器模型库中可能缺少对应的控制器类型，导入时会提示版本不兼容。反过来，用高版本 ROBOGUIDE 打开低版本备份通常可行，但要注意高版本可能自动升级系统参数，导致回迁到现场低版本控制器时出现参数不识别。
二、控制器备份：All of Above 与镜像的区别
迁移前必须从现场控制器取得一份完整备份。FANUC 控制器备份分两类：一类是“All of Above”（文件级备份），另一类是“Image Backup”（镜像备份）。两者用途不同，迁移场景下通常需要 All of Above。
All of Above 备份包含程序（TP 程序、KAREL 程序）、系统参数、I/O 配置、用户坐标系、工具坐标系、寄存器数据等，可以在 ROBOGUIDE 中通过“Restore”导入，是程序迁移的主要数据来源。Image Backup 是整盘镜像，用于控制器故障后的整机恢复，不能直接导入 ROBOGUIDE 做程序级迁移。
备份操作路径：在示教器上按 MENU → 7 FILE → Backup/Restore → Backup (All of Above)，选择存储介质（U 盘或 CF 卡），等待完成。备份完成后应检查备份目录下是否包含 SYSTEM、PROGRAMS、CONFIG 等子目录，缺失任何一项都说明备份不完整。
三、选项授权检查：程序能否跑起来的前提
选项授权（Option）是迁移中最容易被忽略的一环。现场控制器上安装了哪些选项，ROBOGUIDE 中必须对应勾选，否则程序中的指令会编译失败。常见需要检查的选项包括：
- Multi-Tasking（多任务）：程序中使用多任务时必需；
- iRVision / Vision：视觉程序迁移时必需；
- Coordinated Motion（协调运动）：双机协调或外部轴协调时必需；
- DCS（Dual Check Safety）：安全区域配置迁移时必需；
- Ethernet/IP、PROFINET 等通信选项：涉及通信配置时必需。
检查方法：在现场示教器上按 MENU → 0 NEXT → 6 SYSTEM → 3 Config，或查看 MENU → 6 SETUP → 4 Option 中的已安装选项列表。将这份列表与 ROBOGUIDE 工作单元创建时勾选的选项逐项比对。ROBOGUIDE 中选项在“Workcell Setup”或控制器属性中配置，勾选后需要重启仿真控制器才生效。
四、工作单元复制与版本控制策略
工作单元复制有两种常见做法：一是“新建空白工作单元 + 导入备份”，二是“复制已有工作单元再替换控制器”。前者干净、可控，适合首次迁移；后者快，但容易把旧工作单元的残留配置带进来。推荐首次迁移用第一种。
复制完成后，必须建立版本控制策略。ROBOGUIDE 工作单元本质是一个文件夹，包含 .frw 工程文件、.rob 机器人文件、程序目录和配置目录。建议按以下规则管理：
- 每次迁移前，将工作单元文件夹整体复制一份，命名加日期后缀，如
WC_LineA_20240610； - 用 Git 或 SVN 管理时，只提交程序目录和配置文件，不提交仿真缓存和日志；
- 在
.gitignore中排除*.log、*.tmp、Cache/等目录； - 每次修改后打标签，标签名包含控制器版本和迁移阶段，如
v9.30_pre_migrate。
下面这张图展示了迁移前四项准备工作的检查顺序与依赖关系，以及每项不通过时的处理方向。
把这张检查链走完，再开始导入程序，迁移过程会顺畅很多。实际项目中，建议把上述六步做成一张检查表，每完成一项打勾并记录版本号与日期，作为迁移记录的一部分。这样即使迁移中途换人接手，也能快速定位当前进度和已确认的环境状态。