简介：面向PLC编程初学者与自动化工程师的ST语言入门资料，聚焦汇川H5U系列控制器在AutoShop环境下的结构化文本编程。内容从工程创建讲起，涵盖新建ST工程、在梯形图工程中插入ST子程序及FB/FC的创建方式，并说明变量声明的两种途径与不区分大小写的规则；字元件类型定义部分以D元件为例，讲解D0:D、D0:E等整型与浮点型标注写法。流程控制指令是核心篇幅，逐一解析IF、CASE…OF、WHILE…DO、REPEAT、FOR、EXIT、RETURN的语法与执行逻辑，并提醒死循环风险，另附R_TRIG/F_TRIG边沿触发调用及轴控指令清单。资源包为1个PDF文件，约1.21MB，单文件结构便于随查随用。已有2055人学习，适合希望从梯形图过渡到ST编程、系统掌握语法与指令用法的读者作为案头速查手册。
1. 从梯形图切到 ST：这份手册解决的是“写得出、编得过、跑得稳”
很多做 PLC 的同行第一次在 AutoShop 里把编程语言从梯形图切到 ST，都会经历一个相似的下午：语法看着像 Pascal，写起来像 C，编译一跑全是类型不匹配和数组越界。梯形图里拖几个触点就能跑的逻辑，换成文本编辑后反而要重新想清楚变量类型、循环边界和调用层级。这份《H5U-ST 简易编程手册》就是冲着这个断层来的——它不讲 IEC 61131-3 的宏大理论，而是把工程创建、变量定义、字元件类型标注、流程控制指令、轴控与通讯指令清单、在线修改边界、异常处理码这些真正会卡住人的点，按操作顺序摊开。
它适合两类人：一类是梯形图已经能独立做项目、但被要求用 ST 重构或新写程序的电气工程师；另一类是要在 H5U 平台上做轴控、凸轮、编码器计数这类逻辑密度高的模块，梯形图写起来太占页面、想换文本表达的人。手册的价值不在“教你编程语言”，而在“告诉你这套软件里 ST 的脾气”——哪些写法编译得过、哪些运行期才炸、报错码对应什么、在线修改能改到哪一层。下面按我实际拆这套东西的顺序，从建工程一路写到避坑和验证。
2. 工程创建与变量落地：ST 页面怎么插、字元件类型怎么标
2.1 新建 ST 工程与在梯形图工程里插 ST 子程序
手册给的两条路径对应两种真实场景：全新项目直接上 ST，或者老梯形图项目里局部换 ST。第一种在 AutoShop 里新建工程时，编辑器列表选 ST，建完默认程序页就是文本编辑；后续新增子程序、FB/FC 时可以逐页选 ST 或梯形图，等于允许混编。第二种是在已有梯形图工程里，右键程序页插入子程序，类型选结构化文本 ST，FB/FC 同理。混编这件事很实用——轴控初始化、状态机、字符串处理用 ST 写，互锁和调试用的手动逻辑留在梯形图，两边共享变量表。
操作上没什么玄学，但有一个顺序习惯值得养成：先建工程、再定变量表、最后写逻辑。原因是 ST 里变量不声明就引用，虽然按 Enter 或点基本块外区域会自动弹定义框，但自动推断出来的类型经常不是你想要的，尤其是字元件。
操作路径（AutoShop 内）： 1. 新建工程 → 编辑器列表选 ST → 确定 2. 已有梯形图工程：右键程序页 → 插入子程序 → 类型选 ST 3. FB/FC 新建时同样在类型下拉里选 ST 4. 程序页内输入变量名 → Enter 或点击基本块外区域 → 弹出变量定义框这段不是代码，是操作序列，列出来是因为新手最容易在“插入子程序”那一步选错类型，插成梯形图后再想转 ST 只能删了重建。变量定义框自动弹出这个设计省事，但它只负责“让你少跳一次变量表”，不负责“帮你选对类型”，类型这件事必须自己盯。
2.2 字元件类型标注：D0、D0:D、D0:E 的区别
这是整份手册里最容易被低估的一节。H5U 里以 D 元件为例，程序里写 D0，默认按 16 位整型处理；要当 32 位双整用，得写成 D0:D；要当浮点用，写成 D0:E。RW 元件同理。也就是说，同一个物理软元件，你在 ST 里用不同的后缀去“声明”它的解释方式，编译器据此做类型检查和运算展开。
| 写法 | 解释类型 | 典型用途 | 注意点 |
|---|---|---|---|
| D0 | 16 位整型（默认） | 开关量计数、小范围状态字 | 参与 32 位运算前要显式转换 |
| D0:D | 32 位双整（DINT） | 累计脉冲、大计数值 | 占用 D0、D1 两个元件 |
| D0:E | 浮点（REAL） | 速度、位置、比例系数 | 同样占两个字，注意别和相邻变量重叠 |
血泪经验在这里：D0:D 和 D0:E 都会吃掉两个连续元件，如果你在变量表里已经把 D1 分给了别的用途，再写 D0:D 就是自己踩自己。我一般会在变量表里给这类“跨字”变量留出空档，或者在注释里标清楚占用范围。另外类型标注只影响 ST 里的解释，不改变底层存储，所以同一块数据在梯形图侧按字读、在 ST 侧按浮点读，读出来对不上是正常的——不是 bug，是你自己没统一口径。
2.3 常数表示与显式/隐式类型转换
常数支持带下划线分隔，十进制直接写，也可以写 16#FF_AE_12、2#1100_1111_11_10 这种进制前缀加分组，长位串读起来不容易数错位。转换方面，手册列了 INT_TO_DINT、INT_TO_REAL、REAL_TO_INT、TO_BOOL 这一串显式转换函数，隐式转换的规则是 int 可以隐式转 DINT 或 REAL，DINT 也能往某些方向走，但其余组合不行。
a := 100; // 十进制 b := 16#FF_AE_12; // 十六进制，下划线仅作分组 c := 2#1100_1111_11_10;// 二进制分组 d := INT_TO_REAL(a); // 显式转换，别省参数说明：进制前缀后面的下划线不参与数值，只是给人看的；显式转换函数名里的 TO 前后是源类型和目标类型，写反了编译直接报错。隐式转换能省事，但在轴控参数和浮点运算里我建议一律显式写，因为隐式转换的截断方向在调试时很难一眼看出来，等位置偏了再回头查类型，成本比多敲几个字符高得多。
3. 流程控制与调用结构：IF/CASE/循环怎么写才不翻车
3.1 IF、CASE 与三种循环的边界
IF 是布尔条件分支，ELSIF 可以串多个；CASE 的条件变量只能是整数，按值罗列分支，支持一个分支挂多个值（value3, value4, value5 共用一个处理），最后用 ELSE 兜底、END_CASE 收尾。循环有三种：WHILE 先判后执行，条件初始为假就一次不跑；REPEAT 先执行后判，至少跑一次；FOR 带计数器、初值、终值和可选步长，步长不写默认 1，初值大于终值时循环体不执行。
// CASE：条件变量必须是整数 CASE nStep OF 0: bStart := TRUE; 1, 2, 3: nCount := nCount + 1; // 多值共用分支 10: bDone := TRUE; ELSE nStep := 0; // 兜底，防非法值卡死 END_CASE; // FOR：步长可正可负，注意终值判断 FOR i := 0 TO 9 BY 1 DO aArray[i] := 0; END_FOR;逻辑说明：CASE 的 ELSE 不是可选项而是保命项，条件变量来自外部输入或计算时，没有 ELSE 就可能整段逻辑静默跳过。FOR 的循环变量是整数类型，循环体执行前先检查计数器是否不大于终值，所以初值大于终值时一次都不跑——这个行为和某些高级语言不一样，别想当然。WHILE 和 REPEAT 的死循环风险手册专门点了名：条件永远为真或永远为假，程序就停在那里，看门狗会介入，但产线已经停了。
3.2 EXIT、RETURN 与 FB/FC/子程序/中断的调用差异
EXIT 用于跳出 FOR、WHILE、REPEAT 循环，跳出的是当前这一层；RETURN 是条件满足时直接离开当前 POU，后面的语句不执行。手册给的例子很直白：IF b=TRUE THEN RETURN; END_IF; 之后那句 a:=a+1 就不会跑。这两个指令在状态机里用得最多——异常分支提前 RETURN，比层层嵌套 IF 干净。
调用结构这块差异必须记牢：FB 的输入参数除轴参数是必须引脚外，其他引脚可以不接，输出也可以空着；FC 的输入引脚必须全部输入，否则编译报错，输出可以为空；子程序按无参函数形式调用，写 SBR_001(); 就行；中断不用手动调用，开中断用 EI()、关中断用 DI()。嵌套层数有硬限制：FB、FC 嵌套不超过 8 层，SBR 嵌套不超过 6 层。
testfb(m0, m1); // FB：部分引脚可省 testfc(m0, =>m1); // FC：输入必须给全，输出可空 SBR_001(); // 子程序：无参调用 EI(); // 开中断 DI(); // 关中断参数说明：FB 调用时输入完左括号按 TAB 能快速调出引脚列表，引脚后默认值是“???”的表示强制输入，必须填；FC 同理，但 FC 的输入引脚没有“可省”这一说。嵌套层数超限是编译期报错，不是运行期，所以早点把调用链画清楚比事后拆函数省事。中断里我一般只放极短的置位/计数逻辑，长逻辑放中断里会把扫描周期拖成玄学。
3.3 快捷输入、注释与悬浮提示
输入指令名支持联想，按 TAB 补全引脚；引脚默认参数是“???”的强制填，其余按需。注释两种：// 到行尾，(* ... *) 跨行，右键或 Ctrl+/ 也能出注释。鼠标悬浮在变量上显示名称、类型、注释，悬浮在 FB/FC/指令上显示函数名、类型、注释和引脚表——调试时这个悬浮提示比翻手册快。
MC_Jog(Enable := ???, Axis := ???, JogForward := ???, JogBackward := ???, Velocity := ???, Acceleration := ???, Deceleration := , CurveType := , Busy => , CommandAborted => , Error => , ErrorID => );这段是手册里 MC_Jog 的引脚模板，能看出哪些是强制（???）、哪些可空。实际写的时候把 ??? 换成变量，可空引脚按需接。注意末尾多出来的分号别照抄，那是模板排版留下的，正常调用一个分号收尾。
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_MoveBuffer 多段位置、MC_MoveSuperImposed 运动叠加、MC_TouchProbe 探针这类进阶件。凸轮齿轮组里 MC_CamIn/MC_CamOut 起停凸轮、MC_GearIn/MC_GearOut 起停齿轮、MC_Phasing 做主轴相位偏移、MC_GenerateCamTable 和 MC_SaveCamTable 管凸轮表、MC_DigitalCamSwitch 做电子凸轮挺杆。编码器组分高速计数器（HC_ 前缀）和编码器轴（ENC_ 前缀）两套，注意 ENC_SetUnit、ENC_SetLineRotationMode 只对本地编码器轴有效，ENC_Reset、ENC_ResetCompare、ENC_GroupArrayCompare、ENC_ReadStatus、ENC_DigitalOutput 只对总线编码器轴有效——选错对象编译可能过、运行不生效。通讯组是 ETC_ReadParameter_CoE、ETC_WriteParameter_CoE 读写从站 SDO，ETC_RestartMaster 重启主站。定时器组 TPR 脉冲、TONR 接通延时、TOFR 关断延时、TACR 时间累加，和梯形图侧的定时器语义要对齐再用。
| 分组 | 代表指令 | 选型要点 |
|---|---|---|
| 基本轴控 | MC_Power / MC_MoveAbsolute / MC_Home | 先使能再运动，回零方式按机械结构定 |
| 插补与轴组 | MC_MoveLinear / MC_MoveCircular / MC_GroupStop | 轴组指令要求轴已加入组，停止用组级 |
| 凸轮齿轮 | MC_CamIn / MC_GearIn / MC_Phasing | 凸轮表先 Generate 再 Save，相位偏移在运行中调 |
| 编码器 | HC_Counter / ENC_Compare | 本地轴与总线轴指令不通用，先确认轴类型 |
| 通讯 | ETC_ReadParameter_CoE / ETC_RestartMaster | SDO 读写注意索引子索引，重启主站会断通讯 |
这张表不是让你背指令，是让你在写之前先确认“我这条轴是本地还是总线、这个功能属于哪组”，因为手册里明确标了“仅本地”“仅总线”的指令不少，混用是最常见的无效调试。
4.2 在线修改的边界：能改什么、不能改什么
在线修改和梯形图一致，但范围有明确红线。能改的：函数名范围内的修改，只要函数始末处加 ; 或 (* 及空格、TAB、换行，函数标号不变；全局变量支持增删、支持改变量名和注释，其他特性不支持；FB/FC 局部变量支持增删 Var 类型变量，本次在线修改周期前增加的 Var 变量支持改名和注释，本周期内增加的 Var 变量支持全部特性修改。不能改的：增删程序文件、重命名程序文件、改程序文件属性、加解密子程序、修改配置；FB/FC 局部变量里 IN/INOUT/OUT 类型变量不支持增删改。
在线修改前自检清单： 1. 是否只动了函数体内部，函数始末标号是否保持 2. 是否新增/删除了程序文件（禁止） 3. 是否改了 IN/INOUT/OUT 引脚（禁止） 4. 全局变量是否只做了增删或改名/注释 5. 配置项是否原样未动这份清单是我照着手册边界抄下来贴在工位上的，因为在线修改翻车往往不是逻辑写错，而是改了一个“以为能改”的东西，下载时被拒或者更糟——部分生效。尤其是 IN/INOUT/OUT 引脚，运行中改它等于改接口契约，软件拦你是保护你。
4.3 异常处理：除零、数组越界、死循环的报错码
手册给了三类运行期异常的自动保护。除零：除数为 0 时自动把 0 替换为 1，数码管交替闪 Er 50 81。数组越界：常量在编译期检查、变量在运行期检查，越界后报错并把越界值用数组最大下标表示，BOOL 数组当前不做越界检查，数码管闪 Er 50 80。死循环：自动检查并跳出，程序报错停止运行，故障诊断界面显示错误并可跳转到错误处，数码管闪 Er 15 00 50 82，其中 Er1500 是看门狗超时、Er5082 是死循环报警。
// 数组下标四条硬规矩（手册原文归纳） 1. 常量下标不能超出数组本身大小 2. 下标不能是软元件 3. FB/FC 中下标不能是全局变量 4. 下标不能是表达式 // 附加：复杂结构变量里不允许出现两个变量数组下标这四条不是建议是编译规则，违反就报错。第 3 条尤其反直觉——FB/FC 里想用全局变量当下标，得先把它拷到局部变量再用。第 4 条意味着 aArray[i+1] 这种写法在部分场景下过不了，得先算到临时变量。除零自动替换为 1 这个保护要辩证看：它让程序不崩，但结果可能是错的，所以除法前自己判零仍然必要，别把保护当逻辑。
5. 避坑与排查：五条真金白银的踩坑记录
5.1 现象：D0:E 写完，相邻变量值莫名其妙变了
原因：浮点和双整都占两个连续字元件，D0:E 实际吃掉 D0、D1，如果 D1 已被别的变量占用，就是地址重叠。解决：变量表里给跨字变量预留空档，或在注释里标占用范围，改类型前先查相邻地址分配。
5.2 现象：CASE 分支偶尔整段不执行，也不报错
原因：条件变量来自外部输入或运算，出现了分支未覆盖的值，又没有 ELSE 兜底，程序静默跳过。解决：CASE 一律写 ELSE，ELSE 里做状态复位或报警置位，别留空。
5.3 现象：在线修改下载被拒，提示不支持
原因：动了 IN/INOUT/OUT 引脚，或增删了程序文件、改了配置，这些都在禁止清单里。解决：对照 4.2 的自检清单逐条过，接口类改动走停机下载，别指望在线改。
5.4 现象：编码器比较指令写了不生效，编译却通过
原因：用了“仅本地编码器轴有效”或“仅总线编码器轴有效”的指令，轴类型对不上。解决：先确认轴是本地还是总线，再对照指令表选 ENC_ 或 HC_ 系列，本地/总线不通用。
5.5 现象：程序跑着跑着停了，数码管闪 Er 15 00 50 82
原因：死循环触发看门狗超时加死循环报警，常见于 WHILE 条件永远为真、REPEAT 条件永远为假。解决：故障诊断界面跳转到错误处，检查循环退出条件是否依赖了不会变化的变量；循环里加计数上限做兜底，别裸写 WHILE TRUE。
6. 进阶验证：把手册当检查表用，而不是当读物
这套东西真正用顺之后，我的习惯是把它拆成三张检查表而不是从头读到尾。第一张是“建工程检查表”：新建时语言选对没有、混编时子程序类型选对没有、变量表先于逻辑建好没有。第二张是“类型与下标检查表”：跨字变量地址有没有重叠、CASE 有没有 ELSE、数组下标是不是常量或局部变量、FB/FC 里有没有拿全局变量当下标。第三张是“上线前检查表”：在线修改范围对照过没有、循环有没有退出兜底、除零有没有自己判、轴指令的本地/总线属性核对过没有。
验证方法上，我一般会做一个小型“自检程序页”，把这几类风险各写一个最小用例跑一遍：一个带 ELSE 的 CASE、一个带步长的 FOR、一个故意越界的数组访问看报错码、一个除零看 Er 50 81、一个条件可控的 WHILE 看死循环报警能不能跳转定位。跑完这一页，等于把手册里的异常处理章节亲手验证了一遍，比读十遍文字都牢。
| 验证项 | 预期现象 | 对应报错码 |
|---|---|---|
| 除数为 0 | 自动替换为 1，数码管交替闪 | Er 50 81 |
| 数组变量越界 | 报错并用最大下标表示越界值 | Er 50 80 |
| 死循环 | 程序停止，故障诊断可跳转 | Er 15 00 50 82 |
| 在线改 IN 引脚 | 下载被拒 | 软件提示不支持 |
还有一个小技巧：手册里指令清单很长，但真正高频的就那二十来条。我会把 MC_Power、MC_Reset、MC_MoveAbsolute、MC_Home、MC_Stop、TONR、R_TRIG/F_TRIG 这几条的引脚模板抄到一个独立的“模板页”里，新项目直接复制改参数，省得每次按 TAB 联想再删。R_TRIG 和 F_TRIG 要先在功能块实例表里建实例、类型选对，再在 ST 页里按 r_trig_ins(CLK := , Q => ); 调用，这个“先建实例再调用”的顺序新手最容易漏，漏了就编译不过。
从那以后我每次拿到一份新的 ST 手册，都强制先做一件事：把它的异常码表和在线修改边界抄成一页纸贴在显示器边上，因为这两块是调试时最不想翻文档、又最容易记错的部分。这份 H5U-ST 手册的异常码和在线修改限制写得够具体，值得这么对待。希望帮到你。
本文还有配套的精品资源，点击获取
