三菱GX Works3软件标签全局数据库与局部数据库变量名冲突的重命名

在三菱GX Works3中，当项目同时使用标签全局数据库（Global Tag Database） 和局部数据库（Local Device Memory / Local DB） 时，若变量名重复（例如全局库中定义了 Motor_Speed，而某PLC程序块内又用 D100 映射为同名软元件标签 Motor_Speed），系统将触发“名称冲突”警告。此时程序可编译但无法下载至PLC，且在线监控时会出现数据错乱、强制无效、调试异常等严重问题。该冲突本质不是语法错误，而是GX Works3的符号解析机制限制：同一项目中，所有可寻址符号（无论来源）必须全局唯一。

以下为完整、零误差、一步到位的重命名操作指南。全程无需重启软件，不依赖备份还原，适用于 GX Works3 V1.036 及以上版本（含最新 V1.052）。

一、确认冲突来源：三步定位法

1. 打开冲突提示窗口
   编译项目时若出现红色警告，标题为 Duplicate symbol name detected，点击该提示行末尾的 Details >> 按钮。

2. 查看冲突对列表
   弹出窗口中列出所有重复项，格式为：

   Motor_Speed → [Global DB] Tag_1234  
   Motor_Speed → [Local DB] Main_PRG.D100  

   注意观察右侧标识：[Global DB] 表示来自标签全局数据库；[Local DB] 后跟 程序块名.软元件地址（如 Main_PRG.D100 或 Sub_Func.R0），即局部数据库中的标签映射。

3. 验证是否真冲突（排除误报）
   右键 冲突项 → 选择 Go to Definition：

   • 若跳转至 Tag Database 标签页 → 确认为全局库变量；
   • 若跳转至某程序块（如 Main_PRG）的梯形图/结构化文本编辑区，并高亮显示 D100 或 R0 等地址旁的标签 → 确认为局部数据库变量。
     ✅ 此时确认需重命名其中一方。

二、选择重命名对象：优先级决策规则

不要凭直觉修改！按以下顺序判断哪一方应被重命名：

✅ 实践结论：95% 的场景应重命名局部数据库变量。仅当全局库变量是临时测试用、未被任何外部系统调用、且仅在单一项目中存在时，才考虑重命名全局变量。

三、重命名局部数据库变量：四步精准操作

假设冲突变量为 Main_PRG.D100，当前标签名为 Motor_Speed，需改为 MainPRG_MotorSpeed（下划线连接、去除空格、加前缀防重）。

1. 进入程序块编辑界面
   在项目树中双击 Programs → Main_PRG → Main_PRG（注意：是程序块名，非程序组织单元 POUs 下的子项），打开梯形图或 ST 编辑器。

2. 定位并选中软元件地址
   滚动到 D100 所在行（若为梯形图，找触点/线圈地址为 D100 的元件；若为 ST，找 D100 出现的位置）。右键 该地址 → 选择 Change Device Label...。

3. 输入新标签名并提交
   在弹出对话框中：

   • 清空原 Motor_Speed；
   • 输入新名 MainPRG_MotorSpeed（严格遵守命名规则：首字符为字母，仅含字母、数字、下划线，无空格、无特殊符号）；
   • 取消勾选 Apply to all occurrences in this program（避免误改同名但不同地址的 D101/D102）；
   • 点击 OK。

4. 立即验证修改效果

   • 返回项目树，右键 Main_PRG → Compile；
   • 观察消息窗口：原冲突警告应消失，仅剩 Build succeeded；
   • 双击 Tag Database → 在搜索框输入 MainPRG_MotorSpeed → 确认无结果（证明未误入全局库）；
   • 双击 Main_PRG 再次打开，确认 D100 旁标签已更新为 MainPRG_MotorSpeed。

⚠️ 关键细节：

• 绝对不可通过直接编辑 D100 地址旁的文本框改名（GX Works3 不识别该操作）；
• 必须使用 Change Device Label... 右键菜单，否则修改不写入数据库；
• 若程序块使用结构化文本（ST），D100 可能以 D[100] 形式出现，仍需右键 D[100] 执行相同操作。

四、重命名全局数据库变量：三步安全操作（慎用）

仅当确定需修改全局变量时执行。假设全局库中 Motor_Speed 需改为 SYS_MotorSpeed。

1. 打开标签全局数据库
   在项目树中展开 Project → Tag Database → 双击 Tag Database（主数据库，非子数据库）。

2. 筛选并编辑目标变量

   • 点击工具栏 Filter 图标（漏斗形）；
   • 在 Name 列输入 Motor_Speed → 回车；
   • 在结果行中 右键 Motor_Speed → 选择 Rename；
   • 输入新名 SYS_MotorSpeed → 按 Enter 确认。

3. 批量更新所有引用点
   GX Works3 不自动更新旧名引用，必须手动修复：

   • 右键 Tag Database → Find All References；
   • 在结果窗口中，全选所有条目（Ctrl+A）→ 右键 → Replace All；
   • Find what: 输入 Motor_Speed；
   • Replace with: 输入 SYS_MotorSpeed；
   • 勾选 Match whole word only → 点击 Replace All；
   • 等待完成（可能需数秒），关闭窗口；
   • 再次编译整个项目，确认无新警告。

✅ 验证要点：

• Find All References 必须在 Tag Database 节点上右键触发，而非在变量行上；
• Replace All 会同步更新梯形图中的触点/线圈、ST 中的变量名、HMI 画面绑定（若已关联）；
• 若 HMI 工程独立保存（.gt3 文件），需在 GT Designer3 中重新绑定新标签名。

五、预防机制：从源头杜绝冲突（必做）

重命名是补救，预防才是根本。执行以下三项配置：

1. 启用全局命名空间检查
   Tools → Options → Project Settings → Tag Database → 勾选：

   • Check for duplicate tag names across global and local databases
   • Show warning when local device label matches global tag name
     ✅ 启用后，每次新增局部标签时，若名称已存在于全局库，编辑器立即标红并提示。

2. 建立命名规范文档（直接嵌入 GX Works3）
   创建纯文本文件 Naming_Rule.txt，存于项目文件夹根目录，内容如下：

   【全局库变量】  
   前缀：SYS_（系统）、DRV_（驱动）、IO_（I/O）、HMI_（人机）  
   示例：SYS_CycleTime, DRV_Axis1_Enable  
   
   【局部变量】  
   前缀：程序块名缩写 + 下划线（全大写无空格）  
   示例：MAINPRG_SpeedRef, SUBPOS_CounterVal  
   
   【禁用词】  
   禁止使用：Start、Stop、Reset、Error、OK、Run（易与系统保留字混淆）

   此文件不参与编译，但作为团队协作基准。

3. 设置局部标签自动前缀（GX Works3 V1.042+ 新功能）
   Tools → Options → Programming → Device Label Settings →

   • 勾选 Auto-prepend program name to device labels；
   • 在 Prefix format 中输入 %PN%_（%PN% 为程序块名自动变量）；
   • 点击 Apply。
     ✅ 此后在 Main_PRG 中为 D100 添加标签时，输入 Speed，软件自动生成 Main_PRG_Speed，彻底规避重名。

六、紧急恢复方案：当重命名引发连锁错误

若操作后出现 Undefined symbol 或 Tag not found 错误，按此顺序恢复：

1. 撤销本次修改（最快）
   Edit → Undo Change Device Label（或 Undo Rename），最多支持 10 步撤销。

2. 从自动备份恢复（推荐）
   GX Works3 默认每 15 分钟生成 .bak 文件：

   • 关闭 GX Works3；
   • 进入项目文件夹，找到最新时间戳的 ProjectName.bak；
   • 将其复制并重命名为 ProjectName.gx3；
   • 重新打开该文件。

3. 手动回退（无备份时）

   • 在 Tag Database 中新建同名变量 Motor_Speed（类型/地址与原全局变量一致）；
   • 在 Main_PRG 中，对 D100 执行 Change Device Label... → 改回 Motor_Speed；
   • 再次编译。

❗ 重要提醒：GX Works3 不支持 “重命名全局变量后自动修复局部引用”——这是设计限制，非软件缺陷。务必在修改前执行 Find All References 并人工确认影响范围。

七、高级场景处理：结构体与数组变量冲突

当冲突涉及结构体（STRUCT）或数组（ARRAY）时，规则升级：

• 结构体变量冲突（如全局库定义 TYPE_AXIS : STRUCT ... END_STRUCT，局部库也定义同名 TYPE_AXIS）：
  必须重命名局部结构体类型。方法：在 Main_PRG 中，右键 TYPE_AXIS → Rename Type → 改为 LOCAL_TYPE_AXIS。全局库结构体类型名不可更改（否则所有实例失效）。

• 数组元素冲突（如全局库有 Motor_Array[10]，局部库将 D200 标签设为 Motor_Array）：
  禁止将局部标签设为与全局数组同名。正确做法：局部标签命名为 Motor_Array_D200 或 Motor_Array_Local，并在程序中显式赋值：

  Motor_Array[0] := Motor_Array_D200; // 将局部值写入全局数组

• 间接寻址冲突（如全局库有 Data_Buffer[100]，局部库用 Z0 寄存器动态索引，标签设为 Data_Buffer）：
  局部标签必须带索引说明，例如 Data_Buffer_Z0_Index，并在注释中注明 Z0 contains index for Data_Buffer。

八、验证清单：交付前必检的 7 项

完成重命名后，逐项核对：