简介：面向PLC编程初学者与自动化工程师的ST语言入门资料，聚焦汇川H5U系列控制器在AutoShop环境下的结构化文本编程实践。内容从工程创建切入，讲解新建ST工程与在梯形图工程中插入ST子程序、FB/FC的方法，并说明变量声明的两种途径及不区分大小写的规则；进而以D元件、RW元件为例，介绍16位整型、DINT、浮点型等字元件类型的书写约定。流程控制部分系统梳理IF、CASE…OF、WHILE…DO、REPEAT、FOR、EXIT、RETURN等指令的语法与执行逻辑，并提示死循环风险，另附R_TRIG/F_TRIG边沿触发及轴控指令清单。资源包为1个PDF文件，约1.21MB，篇幅精简便于随查随用。已有2055人学习，适合希望从梯形图过渡到ST编程、快速掌握语法要点与常见陷阱的读者。
1. 拿到一份 ST 手册，先别急着翻指令表
上周有个做包装机改造的朋友发来一段 ST 代码让我看，说编译死活过不去，报错指向一行D0 := D100 * 2;。我扫了一眼就问他：D0 你按什么类型用的？他说整数啊。问题就在这——H5U 的 D 元件默认是 16 位整型，你拿它当 32 位算，溢出和类型不匹配全藏在编译期和运行期两个不同的地方。这类坑，手册里其实都写了，但没人愿意从头读到尾。
这份《H5U-ST 简易编程手册》就是干这个用的：它把 AutoShop 环境下 ST 编程语言从建工程、定义变量、写流程控制，到轴控、凸轮、编码器、通讯指令的调用方式，再到在线修改边界和异常处理，压成了一份能对着抄的实操底稿。适合两类人：一是梯形图用熟了、想切 ST 写复杂逻辑的电气工程师；二是接手了别人 ST 程序、需要快速搞懂变量声明和指令引脚含义的维护人员。下面我按自己拆这类手册的习惯，把它拆成能直接落地的几段。
2. 工程创建与变量声明：ST 页面怎么插进梯形图工程
2.1 新建 ST 工程与混合编程的两种入口
AutoShop 里建 ST 工程有两条路，选哪条取决于你手上是全新项目还是改造项目。全新项目直接新建工程，在编辑器列表里把编程语言选成 ST，建完之后默认程序页面全是文本编辑模式。这里有个容易被忽略的点：即便你建的是 ST 工程，新增子程序、FB、FC 的时候仍然可以自由选 ST 或梯形图，也就是说混合编程从工程级别就是允许的，不是非得二选一。
改造项目走第二条路：先建梯形图工程，右键程序页，插入子程序，类型选结构化文本 ST。FB/FC 同理。我一般会建议改造项目走这条，因为原有梯形图逻辑不动，新加的复杂算法用 ST 单独开页面，出了问题好定位，回退也干净。
提示：混合工程里 ST 页面和梯形图页面共享同一套变量表，变量名不区分大小写，
Motor_En和motor_en是同一个东西，命名规范最好在开工前定死。
2.2 变量声明的两种方式与字元件类型后缀
变量声明和梯形图编程保持一致，不区分大小写，有两种定义方式。第一种是在变量表里直接声明，适合批量整理 IO 和全局变量；第二种是在程序编辑区直接写变量名，按 Enter 键或者鼠标点到程序基本块外区域，会自动弹出变量定义框让你声明。第二种方式写起来快，但我踩过的坑是：弹框里类型选错了不容易发现，尤其是批量粘贴代码的时候，建议写完一段就回变量表扫一眼。
字元件类型定义是这份手册里最值得单独拎出来讲的部分。以 D 元件为例，程序里写D0默认是 16 位整型；要定义成 DINT，得写成D0:D；要浮点型，写成D0:E。RW 元件同理。这个后缀不是可选的语法糖，它直接决定编译器按几位数据去解析这个地址。
D0 // 默认 16 位整型 D0:D // 按 DINT（32 位整型）解析 D0:E // 按浮点型解析 RW0:D // RW 元件同理，按 DINT 解析逻辑说明：后缀写在元件名后面、用冒号连接，编译器看到后缀就切换解析宽度。参数说明上，:D对应双整型，占两个字；:E对应实数，同样占两个字。这里的关键边界是——同一个 D 地址在不同程序页里必须用同一种后缀，否则一个页面按 16 位写、另一个页面按 32 位读，数据错位是必然的，而且这种错位在编译期往往不报错，只在运行值上体现，属于典型的黑匣子问题。
2.3 常数表示与类型转换的写法
常数支持三种进制写法，十进制直接写，其他进制带前缀并用下划线分组：10#100_10、16#FF_AE_12、2#1100_1111_11_10。下划线只是可读性分隔，不参与数值计算，我习惯每四位一组，跟看寄存器位图对得上。
类型转换分手动和隐式两类。显式转换用INT_TO_DINT、INT_TO_REAL、REAL_TO_INT这类函数名直写。隐式转换的规则手册写得很克制：int 可以隐式转 DINT 或 REAL，int、dint 可以隐式转……原文这里表述有截断，实操中我按保守原则处理——凡是跨类型赋值，一律显式写转换函数，不赌编译器的隐式规则。血泪经验是：隐式转换在简单赋值里看着没事，一旦进了数组或者 FB 引脚，报错信息会指向一个跟根因完全无关的行号。
3. 流程控制指令：IF、CASE、三种循环和两个跳转
3.1 IF 与 CASE 的分支写法
IF 的语法是IF <布尔表达式> THEN ... ELSIF ... END_IF;，ELSIF 可以有多层。写 IF 我只有一个硬规矩：每个分支体不超过一屏，超了就抽成 FC。ST 的缩进不像梯形图有网络边界，长分支读起来非常费眼。
CASE 适合一个整数变量对应多个离散值的场景，比如工位号、配方号。语法是CASE <Var1> OF加若干<value>: <Instruction>，支持一个分支挂多个值（<value3, value4, value5>:），最后可以带 ELSE。注意手册明确写了条件变量只能是整数，你拿 REAL 或者 BOOL 去 CASE，编译直接拦。
CASE StationNo OF 1: ValveA := TRUE; 2, 3: ValveB := TRUE; // 多个值共用一个分支 4: ValveA := FALSE; ValveB := FALSE; ELSE Alarm := TRUE; // 非法工位号兜底 END_CASE;逻辑说明：StationNo 是整数条件变量，按值匹配进入对应分支，都不匹配走 ELSE。参数说明：分支值必须是常量整数，不能写变量或表达式；ELSE 建议永远写上，作为非法值的兜底，这是我在现场调试时养成的习惯——没有 ELSE 的 CASE，遇到越界值就是静默不动作，排查起来比报错还费时间。
3.2 WHILE、REPEAT、FOR 三种循环的选用边界
WHILE 是条件在前，WHILE <布尔表达式> DO ... END_WHILE;，条件为 TRUE 才进循环，第一次就是 FALSE 则一次都不执行。REPEAT 是条件在后，REPEAT ... UNTIL <布尔表达式> END_REPEAT;，循环体至少执行一次，直到条件为 TRUE 退出。FOR 是计数循环，FOR <INT_Var> := <初值> TO <终值> {BY <步长>} DO ... END_FOR;，步长可选，默认 1，计数器超过终值就停。
选型上我的习惯是：已知循环次数用 FOR，次数不定但可能零次用 WHILE，必须至少跑一次用 REPEAT。手册对死循环的警告写得很直白——WHILE 条件永远为 TRUE、REPEAT 条件永远为 FALSE，都会卡死。H5U 这边有看门狗和死循环检测兜底，PLC 数码管会交替闪Er 15 00和Er 50 82，前者是看门狗超时，后者是死循环报警，程序会报错停止运行，故障诊断界面能跳到出错位置。但别指望这个兜底，它救的是程序，救不了你产线上停机的损失。
3.3 EXIT 与 RETURN 的区别
EXIT 只退出当前所在的 FOR、WHILE 或 REPEAT 循环，循环外面的代码继续跑。RETURN 是直接离开当前 POU，整个程序块都不再往下执行。手册给的例子很典型：IF b=TRUE THEN RETURN; END_IF; a:=a+1;，b 为真时a:=a+1根本不执行。
这两个指令混用是新手高频翻车点。我见过有人在 FOR 里想提前结束整个子程序，写了 EXIT，结果循环退了、后面的逻辑照跑，输出状态跟预期完全对不上。记住一句话：退循环用 EXIT，退程序块用 RETURN。
3.4 边沿触发 R_TRIG / F_TRIG 的实例化方式
上升沿和下降沿不是直接写指令，而是先在功能块实例表里新建 FB 实例对象，FB 类型分别选 R_TRIG 和 F_TRIG，然后在 ST 页面里调用：r_trig_ins(CLK := , Q => );。CLK 接被检测信号，Q 输出一个扫描周期的脉冲。
r_trig_ins(CLK := StartBtn, Q => StartPulse); IF StartPulse THEN RunFlag := TRUE; END_IF;逻辑说明：StartBtn 的上升沿让 Q 输出一个周期的高电平，StartPulse 只在一个扫描周期内为 TRUE。参数说明：CLK 是输入引脚，Q 是输出引脚，实例名r_trig_ins由你在实例表里定，同一个实例不要在多处重复调用，否则沿检测的上一周期状态会被互相覆盖，脉冲宽度变得不可预期。
4. 指令库调用：轴控、凸轮、编码器与通讯的引脚怎么填
4.1 基本轴控指令的调用骨架
手册列了完整的轴控指令表，从 MC_Power 使能、MC_Reset 复位、MC_ReadStatus 读状态，到 MC_MoveRelative 相对定位、MC_MoveAbsolute 绝对定位、MC_MoveVelocity 速度指令、MC_Jog 点动、MC_Home 原点回归、MC_Stop 停止、MC_Halt 暂停、MC_ImmediateStop 急停，再到插补类的 MC_MoveLinear 直线插补、MC_MoveCircular 圆弧插补和轴组类的 MC_GroupStop、MC_GroupPause。这张表的价值不在指令名，在于让你知道哪些动作有专用指令、不用自己拼。
调用骨架以 MC_Jog 为例，手册给的引脚模板是MC_Jog(Enable := ???, Axis := ???, JogForward := ???, JogBackward := ???, Velocity := ???, Acceleration := ???, Deceleration := , CurveType := , Busy => , CommandAborted => , Error => , ErrorID => );。引脚后面默认参数是???的，是强制输入，不填编译不过；其余可以按实际情况决定。
MC_Jog(Enable := JogEnable, Axis := Axis1, JogForward := JogFwd, JogBackward := JogBwd, Velocity := 50.0, Acceleration := 500.0, Deceleration := 500.0, Busy => JogBusy, Error => JogErr, ErrorID => JogErrID);逻辑说明：Enable 为 TRUE 时点动功能生效，JogForward/JogBackward 决定方向，Velocity、Acceleration、Deceleration 给速度和加减速。参数说明：Axis 是轴参数，属于必须输入的引脚变量；Busy、Error、ErrorID 是输出引脚，用=>接变量。这里有个实操细节——轴参数引脚不是随便填个变量名就行，它得是系统里已经配置好的轴对象，填错类型编译期就报。
4.2 凸轮、齿轮与编码器指令的分组记忆
凸轮齿轮这块，MC_CamIn 开始凸轮、MC_CamOut 解除、MC_Phasing 主轴相位偏移、MC_GenerateCamTable 更新凸轮表、MC_SaveCamTable 保存凸轮表、MC_GearIn 齿轮开始、MC_GearOut 解除、MC_GetCamTablePhase 和 MC_GetCamTableDistance 读凸轮表相位与位移、MC_DigitalCamSwitch 电子凸轮挺杆控制。记忆方法是按「进 / 出 / 查 / 配」四类分：CamIn、GearIn 是进，CamOut、GearOut 是出，Get 开头是查，Generate、Save 是配。
编码器指令分高速计数器和编码器轴两组。HC_ 开头的是高速计数器：HC_Counter 使能、HC_Preset 预置、HC_TouchProbe 探针、HC_Compare 比较、HC_ArrayCompare 数组比较、HC_StepCompare 等间距离比较。ENC_ 开头的是编码器轴，其中好几个带「仅本地编码器轴有效」或「仅总线编码器轴」的限定——ENC_SetUnit、ENC_SetLineRotationMode、ENC_Compare 仅本地有效；ENC_Reset、ENC_ResetCompare、ENC_GroupArrayCompare、ENC_ReadStatus、ENC_DigitalOutput 仅总线有效。这个限定不是注释，是选型依据：你手上是本地编码器还是总线编码器，直接决定哪些指令能用。
4.3 通讯、定时器、中断与字符串指令
通讯指令只有三条：ETC_ReadParameter_CoE 读从站 SDO 参数、ETC_WriteParameter_CoE 写从站 SDO 参数、ETC_RestartMaster 重启主站。定时器四条：TPR 脉冲定时器、TONR 接通延时、TOFR 关断延时、TACR 时间累加。中断两条：EI 开启、DI 关闭。字符串一条 STRMOV。其他指令里 ZSET 批量置位、ZRST 批量复位、BITW 十六位转字、WBIT 字转十六位、ModReal 实数取余、MSET 内存设置、MCPY 内存复位。
BITW 和 WBIT 这对在写通讯打包解包时特别顺手，一个字的 16 个位和 16 个 BOOL 之间来回转，比逐位赋值干净。ModReal 做实数取余，浮点运算里偶尔要用，别自己拿减法循环凑。
4.4 FB、FC、子程序、中断的调用差异与嵌套上限
这四类调用形式完全不同，混了就是编译错误。FB 的输入参数里，轴参数是必须输入的引脚变量，其他引脚包括输出都可以不填；FC 的输入参数引脚必须输入，否则编译报错，输出参数可以为空；子程序以无参函数形式调用，写SBR_001();；中断不用手动调用，开中断调 EI、关中断调 DI。
引脚快速调出有个快捷键：输入完左括号(后按 TAB 键。FB 的例子是testfb(m0,m1)变成testfb()再按 TAB 展开引脚；FC 的例子是testfc(m0,=>m1)变成testfc(m0)。嵌套层数有硬上限：FB、FC 嵌套调用不能超过 8 层，SBR 嵌套不能超过 6 层。超了编译报错，这种报错信息通常指向最外层调用，根因在嵌套深处，排查时从调用链末端往回数层数最快。
5. 避坑清单：在线修改、数组下标和异常码的五个真实翻车点
5.1 在线修改改了函数名，标号变了导致下载失败
现象：在线修改时顺手改了个函数名，下载报错或者修改不生效。原因：手册写明了在线修改的范围——函数名范围内修改，标号会改变；只有在函数始末处添加;、(*以及空格、TAB、换行，该函数标号才不变。解决：在线修改阶段不动函数名，要改名就下线改完整体下载；非改不可时，在函数首尾加注释符或分号保持标号稳定。
5.2 在线修改想加程序文件，软件直接不给选项
现象：想在线新增一个程序文件或者重命名现有文件，发现操作被禁。原因：手册的限制清单写得很清楚——不支持增、删程序文件，不支持重命名程序文件，不支持修改程序文件属性，不支持加解密子程序，也不支持修改配置。解决：这些操作全部放到离线做，在线只做逻辑体内部的修改。全局变量支持增删、支持改变量名和注释，其他特性不支持；FB/FC 局部变量不支持增删改 IN/INOUT/OUT 类型，只支持增删 Var 类型。本次在线修改周期前增加的 Var 变量，只支持改名和注释；本周期内增加的 Var 变量才能全特性改。这条边界记不住，就会反复撞墙。
5.3 数组下标用了软元件或表达式，编译报错指向莫名其妙的位置
现象：数组访问写成Arr[D100]或者Arr[i+1]，编译报错，行号对不上。原因：手册的数组下标注意事项列了五条——常量下标不能超出数组大小；下标不能为软元件；FB/FC 中下标不能为全局变量；下标不能为表达式；复杂结构变量中不允许出现两个变量数组下标。解决：下标统一用局部整型变量，进数组前先做范围判断；FB/FC 里要用全局值当下标，先赋给局部变量再用。
5.4 除零和数组越界不报编译错，只在运行期闪 Er 码
现象：程序跑着跑着 PLC 数码管交替闪Er 50 81或Er 50 80，逻辑停摆。原因：除数为 0 时系统自动把 0 替换成 1 并报Er 50 81；数组越界常量在编译期检查、变量在运行期检查，越界后报错并把越界值用数组最大下标表示，报Er 50 80。注意当前阶段 BOOL 数组没做越界检查，这是手册明说的缺口。解决：除法前显式判零，数组访问前显式判上下界，BOOL 数组自己加保护，别指望系统兜底。
5.5 死循环触发看门狗，故障码要会读
现象：程序卡死，数码管闪Er 15 00和Er 50 82。原因：Er 15 00是看门狗超时，Er 50 82是死循环报警，两者常常一起出现。解决：故障诊断界面会显示错误信息并能跳转到错误处，先跳过去看是哪个 WHILE 或 REPEAT 的条件写反了；修完之后在循环体里加计数器上限做二次保护，别让同一段代码有第二次卡死的机会。
6. 把手册用成检查表：上线前我固定跑的四个验证动作
手册读到最后一章，真正值钱的不是记住了多少条指令，而是把它变成一套上线前的固定动作。我自己现在每次 ST 程序下载前，会按顺序过四件事，每件都对应手册里的一个具体边界。
第一件，扫一遍所有字元件后缀。用文本搜索把:D和:E列出来，逐个确认同一地址在所有页面后缀一致。这一步花不了五分钟，但能挡掉大部分运行期数据错位。第二件，检查数组下标。把所有Arr[出现的位置过一遍，确认下标是局部整型变量、有范围判断、FB/FC 里没有直接用全局变量。第三件，数嵌套层数。FB/FC 调用链从末端往回数，不超过 8 层；SBR 不超过 6 层。第四件，确认在线修改计划。要改函数名、要加程序文件、要动 IN/INOUT/OUT 引脚的，全部挪到离线窗口，在线只做逻辑体内部调整。
这四件事对应一张简单的检查表：
| 检查项 | 判据 | 对应手册条目 |
|---|---|---|
| 字元件后缀一致性 | 同一地址全工程统一:D/:E | 字元件类型定义 |
| 数组下标合法性 | 局部变量、有界判断、非表达式 | 数组下标注意事项五条 |
| 嵌套层数 | FB/FC ≤ 8，SBR ≤ 6 | FB/FC/子程序/中断 |
| 在线修改范围 | 不改名、不增删文件、不动 IN/INOUT/OUT | 在线修改限制清单 |
还有两个小技巧值得单独说。一是快捷输入：输入指令名支持联想，按 TAB 补全引脚，引脚默认值是???的必须填，其余可空，这个习惯能把引脚漏填的编译错误提前消灭。二是鼠标悬浮提示：变量悬停显示变量名、类型、注释，FB/FC/指令悬停显示函数名、类型、注释和全部输入输出引脚的类型与注释，调别人程序的时候，先把悬浮提示当文档读一遍，比翻变量表快得多。
最后提一句手册里那个容易被跳过的注：因为梯形图指令转 ST 形式还没全部更新，工具箱快捷输入功能暂时是关闭的，等后续更新才开。这意味着现阶段别指望从工具箱拖指令，老老实实手敲或者用联想补全。我第一次遇到时以为是软件装坏了，折腾了半天重装，后来翻到这条注才明白是版本阶段的已知状态。
从那以后我每次拿到一份新的 ST 手册，第一件事不是从头读，而是先把它拆成「建工程、声明变量、写控制、调指令、避坑、上线检查」六段，每段挑一个能立刻验证的点跑一遍，跑通了再往下。这份 H5U-ST 手册我按这个方式过完，最深的体会是：它的价值不在指令表有多全，而在那些「不支持」「仅本地有效」「不能超过几层」的边界写得足够具体，边界才是现场不翻车的地方。希望帮到你。
本文还有配套的精品资源，点击获取
