企业官网建设流程全解析

做西门子HMI项目迁移的工程师，十有八九都撞见过这种怪事：画面明明从A项目完整复制到B项目，编译也没报错，下载到触摸屏之后，按钮文字、报警信息、单位注释却一溜烟变成了大写的“TEXT”。操作工指着屏幕问这个英文单词是什么意思，你第一反应是程序没传对，重新下载一遍还是TEXT。别急着删项目重做，“SIEMENS触摸屏迁移到另一个项目中显示TEXT问题”其实是文本引用链断裂的典型症状，有固定的排查路径，也能彻底解决。这篇文章就把TEXT问题的成因、排查顺序和可落地的修复方案完整捋一遍。刚接触TIA Portal的新手遇到它会慌，老手大概知道和文本引用有关，但未必系统整理过排查顺序——这两类人都可以参考。

1. 迁移项目后画面显示TEXT：先认准现象和报错类型

1.1 画面上最常见的三种TEXT表现

迁移完成后，TEXT最常出现在三个地方。第一个是报警栏，报警控件在运行时实时弹出故障文本，正常应该显示“电机过载”“气压不足”这类描述，结果全屏滚动TEXT。第二个是按钮标签，启动、停止、复位这些按钮下方的文字变成了TEXT，按下去功能照常，纯粹是显示问题。第三个是IO域周围的注释和单位，温度显示数值正常，但“℃”和“当前温度”这几个字变成了TEXT。

这三种表现的性质不完全一样：报警栏TEXT几乎都是文本列表引用断裂，按钮TEXT可能是项目文本或文本列表引用断裂，IO域注释TEXT还要顺带检查变量连接是否健康。观察时留意TEXT前面有没有符号，比如“@TEXT@”多数指向项目文本，TEXT[2]或TEXT.2多数指向文本列表的条目ID，这些细节能帮助缩小排查范围。

另外注意编译输出窗口。有些TEXT问题编译时会有提示，比如“对象'报警[20]'的文本引用无效”或“无法解析文本引用”，找到这些关键字，能直接定位到具体的画面对象。不过也有不少TEXT问题编译时一声不吭，这是文本引用机制的坑，后面会说为什么。

1.2 TEXT到底是什么：文本引用链断裂的占位符

要彻底解决TEXT，得先明白HMI文本的存储机制。触摸屏画面上的文字，组态时有两种存储方式。第一种是静态文本，直接在对象属性里敲入“启动”，运行时就永远显示“启动”。第二种是引用式文本，画面对象里并不直接保存文字，而是保存一个引用关系，比如“文本列表AlarmTexts的第10号条目”或“项目文本节点'MotorOverload'”，运行时面板根据当前语言，去文本表里查出真正要显示的文字。

引用式文本是为多语言切换设计的。设备要出口，操作界面要切换中英文，直接在画面里敲死文字就没法自动翻译；改成文本列表就能做到一套画面、多语言自动切换。代价是引用链一旦断裂，系统查不到文本值，运行时只能显示一个占位符。在TIA Portal里，这个占位符的默认显示就是“TEXT”。

打个比方，这和Excel里公式引用另一张工作表有点像：源工作表一旦被删掉，公式单元格就显示“#REF!”。TEXT就是HMI世界里的“#REF!”，它是在提示你“这里有一个文本引用没找到对应项”，而不是程序损坏或者屏坏了。所以看到TEXT，第一反应应该是“哪个引用断了”，而不是“重新传一遍试试”。

2. 三个导致TEXT的根因，多数人栽在第二个

2.1 根因一：HMI变量与PLC连接的引用失效

先说第一个根因——变量连接。

HMI变量表里，每个变量都需要指定一个PLC连接，例如连接“新_连接_1”下的PLC变量“I0.0”或“DB1.DBX0.0”。这个连接关系会跟着HMI变量一起被记录下来。从A项目复制变量表和画面到B项目时，如果B项目的PLC连接名称变了，或者连接指向的PLC变量名对不上，变量就会处于“未连接”状态，表格里出现黄色感叹号。

变量连接失效不会直接让画面显示TEXT，但会让画面对象整体处于不健康状态。比如IO域的过程值属性里选中的HMI变量失效，这个IO域可能出现“#####”或数值不变；而按钮的“使能”或“可见性”绑定到失效变量后，按钮文本也可能随之失去正常渲染。更常见的是，报警控件里报警的“触发变量”失效时，报警文本的显示也会连带出问题。

所以排查TEXT，先把变量连接这一层排除掉，不要一上来就钻到文本列表里。在HMI变量表里扫一眼“连接”列，如果有空值或叹号，优先重建连接。这个检查最多花三分钟，但能避免后面一半的无效排查。

2.2 根因二：文本列表没有跟着画面一起走

这是TEXT问题里最典型的根因，也是标题里“迁移”最直接的坑。

画面对象引用文本列表时，复制的只是“引用本身”，不是“文本列表的定义”。比如A项目中，报警文本的内容放在文本列表“报警文本”里，条目ID=1是“电机过载”，ID=2是“气压不足”。当你把报警控件复制到B项目时，控件记住的是“报警文本这个列表的ID=1条目”，但B项目里根本没有“报警文本”这个列表，或者有列表但没有ID=1这个条目。运行时查不到，屏幕上就是TEXT。

这个机制坑人之处在于，复制HMI画面时，TIA不会主动问“要不要把引用的文本列表一起复制”，它把这件事交给用户。很多工程师不知道文本列表独立于画面存在，迁移完只看到画面，没意识到文本数据也要迁移。

还有一个更隐蔽的细节：就算你在B项目里新建了一个同样叫“报警文本”的列表，只要条目ID和源项目不一致，照样显示TEXT。因为控件绑定的是条目ID，不绑定文本值。我见过有人在B项目重新录了一遍报警文本，条目顺序和源项目不同，结果一半报警正常、一半TEXT。所以文本列表的迁移，最好用导出导入，而不是手工重建，确保ID完全一致。

2.3 根因三：项目语言和参考语言不一致

第三个根因相对隐蔽，但多语言项目里很常见。

TIA的HMI设备有“项目语言”和“参考语言”两个概念。参考语言是组态时你正在使用的编辑语言，比如你在中文参考语言下输入了“启动”两个字，这些文字会存在中文语言列里。如果你把画面复制到一个参考语言为英文的项目中，画面里原本在中文列的文字可能匹配不到英文列内容，运行时按英文语言去查表，查不到就显示TEXT。

项目文本的机制也一样。项目文本表里每条记录有多个语言列：中文、英文、德文……如果在目标项目的参考语言下没有录入对应翻译，引用就取不到值。这种现象跟前面的文本列表丢失可以叠加出现，排查时需要区分：是所有文本都TEXT，还是只有某一种语言下TEXT？如果切换语言后有些文本能正常显示，基本就是参考语言和项目语言设置的问题。

处理起来不复杂：在HMI设备属性“常规->语言”里，把参考语言改成和源项目一致，或者把源项目的语言数据一并导入。关键是别忽略这个维度，因为有时候你修好了文本列表，TEXT还在，就是语言这一层没对上。

3. 四种场景的修复方法，按这个顺序排查最快

3.1 场景A：变量连接失效，IO域与报警变量全断

遇到TEXT先不要进画面改字，按下面的步骤走。

第一步，打开项目树里该HMI设备下的“HMI变量”表格，看“连接”列。如果有空值或黄色感叹号，说明变量连接断了。接下来打开“设备与网络”，确认HMI和PLC之间是否建立了连接。如果没有，先拖一根连接线，把连接名称记录下来。

第二步，回到HMI变量表，在“连接”列下拉菜单里选择正确的连接。如果连接名和源项目不一致，可以先把连接建得和源项目一样，或者统一改成新项目的连接名，总之内部命名一致即可。

第三步，编译一次。编译输出窗口里搜“未分配”“无效”这些词，能快速列出所有变量引用问题。之后再到画面里，选中IO域或报警控件，在属性面板“过程值”属性中重新选择HMI变量。如果画面很多，可以在画面里Ctrl+A全选对象，批量检查属性里的变量引用。

这一步做完，变量连接层面的问题应该清零。

3.2 场景B：文本列表丢失，报警文本和按钮文本变TEXT

变量连接没问题，但TEXT还在，九成是文本列表和项目文本的问题。

第一步，在项目树中找到该HMI设备下的“文本和图形列表”，对照源项目，看目标项目缺哪些列表。缺了就直接在源项目里右键列表名，选择“导出”，目标项目里右键空白处“导入”。导入后展开列表，确认条目ID完整带过来了。

第二步，如果列表已经存在但就是显示TEXT，重点比对条目ID。举个例子：源项目里ID=3是“复位中”，目标项目里ID=3可能是“复位完成”或者干脆没有ID=3。画面对象引用的是ID，不认文本，ID对不上就会TEXT。这种细微差别只有逐条核对才能发现。

第三步，去画面对应的报警控件或按钮，在属性面板的“文本”分类里，把引用方式重新指定一次。报警控件通常有两个地方会引用文本：报警表格里的“报警文本”属性和报警控件本身绑定的“文本列表”。重点检查后者，控件属性里如果引用了一个不存在的列表，运行时全部报警都会TEXT。

第四步，重新编译并下载。这个场景下修复后，画面里大部分TEXT会一次性恢复。另外，如果只想尽快让设备跑起来，可以省掉复杂绑定，直接把按钮文本改成静态文字。右键按钮，属性“文本”类型选“无”，然后直接输入中文。等于砍掉多语言能力，代价小、见效快，适合交期紧、又确实不需要切换语言的设备。

3.3 场景C：旧版WinCC flexible项目移植后的残留问题

从WinCC flexible 2008往TIA Portal移植，是另一条高频踩坑路线。

旧项目移植到TIA后，报警文本、按钮文本、系统消息都可能变成TEXT。原因和前面差不多：移植时文本列表和项目文本没有被完整带进新工程。差别在于，移植向导里有一个选项容易被跳过。

具体做法是：在TIA里选“项目->移植”，选择旧项目文件后，移植向导会问你要不要传送更多内容，包括“传送所有文本”“传送项目文本/文本列表”。这两个选项务必勾上。不要只看画面，觉得画面过来了就完事，文本数据在移植过程中是独立的环节。

移植完成后还要检查语言设置。旧项目里参考语言是中文，新项目里如果参考语言默认成了英文，画面里那些引用文本就可能取不到中文，运行时直接TEXT。把参考语言改回来，或者把旧项目的语言数据导入进来，问题就能解决。

如果移植后只是个别报警显示TEXT，优先检查报警类别。WinCC flexible里报警文本可以挂在“报警类别”上，移植后报警类别映射有时会丢，重新给报警类别指定文本列表即可。另外老版本软件跑在32位环境下，移植前把工程文件路径里的中文和空格处理干净，能省掉不少莫名其妙的小问题。

3.4 场景D：几十张画面批量修复TEXT的高效做法

画面少可以一个个改，遇到几十张画面的项目，就必须用批量手段。

第一招，用TIA的查找和替换。Ctrl+F打开搜索框，搜索范围选“HMI画面”，输入“TEXT”，语言筛选记得关掉，不然可能漏掉一部分对象。搜出来之后逐个确认是不是要修复的文本，统一替换成正确的静态文本，或者替换成正确的引用格式。

第二招，CSV导入导出。文本列表和项目文本都可以右键导出CSV文件。在源项目里导出，Excel打开检查，目标项目里再导入。这招在处理数十条报警文本时尤其好用，比手工添加快一个数量级，还能保证条目ID完全一致。导入之后编译一下，确认所有条目都在。

第三招，批量处理报警表格。报警文本不要进画面改，直接在HMI的“报警”表格里选中多行报警，在“文本”列统一重新选择文本列表条目。一次选中所有报警行，批量赋值，效率很高。

做批量操作前一定要把文本列表修复好，否则批量替换只是把一种错误换成另一种错误。顺序不能反。

4. 一次迁移TEXT问题的完整修复实录

4.1 故障现场：报警栏飘满TEXT，按钮全成了英文占位符

说一个具体的案例，很有代表性。某设备的HMI程序要从项目A迁到项目B，项目B的PLC型号一致，但变量表做过重构，大概三成PLC变量改了名字，HMI的连接名也从原来的“PLC_1”变成了“新_连接_1”。迁移方式很粗暴：直接TIA里复制画面、粘贴过去。下载运行后，报警栏滚动显示TEXT，启动和停止按钮文字也是TEXT，IO域数值能正常显示，但单位旁边的注释文字全是TEXT。

第一件事没有进画面，而是打开HMI变量表扫“连接”列，发现一批变量带黄色感叹号。再打开“文本和图形列表”，果然，目标项目里压根没有“报警文本”这个列表。到这里基本定位到两块问题：变量连接断加文本列表丢失。

4.2 修复过程：连接重建、文本列表导入、逐项验证

修连接花了大概十五分钟。先在“设备与网络”里把HMI到PLC的连接补上，命名为“新_连接_1”；回变量表把所有带叹号的变量，在连接列里重新选到“新_连接_1”；编译一次，确认没有未分配引用。

修文本列表反而是最快的。在源项目里右键“报警文本”文本列表，导出CSV；目标项目里右键“文本和图形列表”空白处，导入刚才的CSV。打开列表看了眼，条目ID都完整带过来了。然后打开报警表格，把报警文本的引用方式重新指定为“文本列表->报警文本->对应条目”。这一步做完，编译，下载，报警栏的TEXT全部恢复。

按钮文本单独处理。启动按钮在属性“文本”分类里引用了项目文本节点“启动”，但目标项目的项目文本表里没有这个节点。我在项目文本编辑器中补上了这个节点和中文/英文翻译，按钮文字恢复。如果你嫌麻烦，也可以直接改静态文本，但考虑到设备可能出口，我当时保留了引用方式。

4.3 这次修复复盘：哪些步骤真正节省了时间

复盘下来，最省时间的是先做文本列表导入而不是先逐条修按钮文本。文本列表带过来之后，画面里一半的TEXT其实已经自动恢复，因为报警控件和按钮绑定的是“列表名+条目ID”，列表存在且ID一致，运行时就能查到文本。剩下那些还显示TEXT的，才是真正需要逐个手动处理的。

第二个省时间的点是用了CSV而不是手工录入。报警文本大概有30多条，手工录入可能一小时起步，导出导入十分钟搞定，还不会出现ID错位。

第三个经验是：编译输出窗口的“文本引用无效”提示要重视。虽然有些TEXT编译时不报错，但凡是报出这个提示的，都是文本列表或项目文本的硬问题，顺着提示双击跳转到具体对象，修一个少一个。

5. 避坑速查表与迁移前必做的准备工作

5.1 常见问题速查表：六种TEXT现象对照

把实际遇到的TEXT现象、原因和解决办法整理成一张速查表，现场排查时可以对着看。

这张表实际用过，大部分现场问题都能对上号。如果碰到表中没有的现象，多数是两种原因叠加，先修文本列表再修连接，顺序别反。

5.2 迁移前必做的三件准备工作

经历过几次TEXT问题之后，我养成一个习惯：迁移HMI程序之前，先花十五分钟做准备工作。

第一件，导出源项目的文本数据。在源项目里分别导出“项目文本”和“文本和图形列表”为CSV，顺手截一张HMI变量表和连接配置的截图。这些东西就像保险单，出问题时能立刻对照，不用再去翻旧电脑。

第二件，在目标项目里把PLC连接和变量表提前建好。HMI迁移最怕目标项目本身还有一堆编译错误，这样根本分不清TEXT是原有问题还是迁移引入的。先把基础打好，再迁移画面，问题边界清晰很多。

第三件，复制对象时看清楚TIA的弹窗。TIA在跨项目复制HMI对象时，会询问是否同时复制引用的对象，比如文本列表、图形列表、项目文本。这个时候要选“包含引用对象”，不要嫌麻烦直接点掉。点掉一时省事，后面修复TEXT花的时间会多得多。

5.3 一条可以少走弯路的排查顺序建议

最后聊点个人经验。TEXT问题本身不难，难的是很多人喜欢从画面里一个一个找着改，改到一半发现根因没解决，白费功夫。

我现在遇到TEXT，固定的排查顺序是：先看“文本和图形列表”，再看“HMI变量表的连接列”，然后“项目语言设置”，最后才“画面对象属性”。这个顺序是按照出现频率排的，文本列表出问题的概率最高，变量连接次之，语言设置较少，画面对象属性本身出问题的概率最低。按这个顺序排查，绝大多数情况下十分钟内就能定位到根因。

还有人问我为什么不用交叉引用功能。交叉引用当然能用，但那是定位“某个变量被哪些对象用了”的工具，适合在明确知道故障变量时用。TEXT问题更多是“引用指向的对象不存在”，先在文本列表和变量表里找缺失项，效率更高。工具用对场景才有价值。