1. 为什么要写这篇教程CODESYS到底解决了什么问题第一次接触CODESYS的人多半是听同行提起“这个软件能做软PLC”“写逻辑跟玩一样”。我当时入坑是因为接手一个项目客户指定要用支持IEC 61131-3标准的控制器而且最好能在一台普通工控机上直接跑逻辑不想再被某个品牌的专用编程软件捆绑。折腾了整整一个下午从下载到跑通第一个程序中间踩的坑说多不多说少也够写一篇长文了——所以这篇就是冲着让你少走弯路来的。先说CODESYS是什么。它是德国3S公司推出的工业控制器编程开发环境基于IEC 61131-3国际标准支持ST结构化文本、LD梯形图、FBD功能块图、SFC顺序功能图、CFC连续功能图等全套PLC编程语言。你可以把它理解成“PLC界的Visual Studio”——它不绑定特定硬件只要你买的控制器支持CODESYS RuntimeCODESYS的运行时内核就能用同一套开发环境写逻辑、调试、下载、监控。这里要重点说一句CODESYS和传统PLC编程软件最大的区别在哪里。传统方式比如西门子的博途、三菱的GX Works软件和硬件是绑死的CODESYS则把“编程工具”和“运行内核”拆开了。你在PC上装的是IDE开发环境控制器里跑的是Runtime运行时两边通过网络或串口通信。这意味着什么意味着只要硬件厂商预装了CODESYS Runtime不管是国产PLC、进口控制器还是你自己做的嵌入式板卡都能用同一个开发环境写程序。像汇川、信捷、禾川等不少国产厂商的中大型PLC底层用的就是CODESYS内核这也是为什么“汇川PLC codesys”会成为热搜词。这篇文章适合谁如果你是自动化工程师、电气工程师、院校学生或者做设备集成的自由职业者只要你想学软PLC或基于CODESYS的控制器编程这篇就能帮你从零打通“下载到配置”这一关。内容会细致到什么程度下载哪个包、装哪个组件、环境变量怎么配、常见报错怎么处理全部覆盖。2. 安装前的准备工作版本选型与系统环境检查2.1 搞清楚自己该装哪个版本这是我见过最多人卡住的第一步。打开CODESYS官网下载页面你会发现版本多得让人眼花缭乱CODESYS V2.3、CODESYS V3.5 SP17、SP18、SP19、SP20……还有所谓的“Development”开发版和“Full”完整版之分如果不提前搞清楚随便下了一个就能把你带沟里。先说结论现在学优先选CODESYS V3.5 SP19及以上版本64位安装包。为什么V2.3是2000年代的老古董虽然界面简单但和现代控制器的兼容性已经跟不上官方早就转向V3系列。V3.5的SP版本相当于迭代补丁包SP19以后的版本对Win10/Win11系统支持更好自带的各种功能库也更全。至于SP20、SP21那是后续的更新版如果你用的控制器厂商要求特定SP版本按厂商要求来没有要求就装最新的没毛病。再说开发版和完整版的区别。官网下载时会让你选“CODESYS Development System”有时也叫试用版和“CODESYS Full Installation”。开发版是核心IDE本体免费使用但部分库和功能需要单独安装完整版把常见的库、工具、在线帮助都打包在一起省心但安装包更大。我的建议是初学选完整版因为省得后面缺一个库又回头找安装包。注意CODESYS虽然免费但它不是开源软件。免费的是“非商业用途的开发环境”如果你要把程序部署到商业产品上需要购买对应的Runtime授权。这个后面会细说。2.2 系统要求与安装前的环境准备CODESYS对电脑的要求不算高但有几个细节一定要提前处理不然装一半报错或者装完打不开心态直接崩。硬件配置方面建议至少4GB内存8GB更舒服、i3及以上CPU、20GB可用磁盘空间。这只是运行IDE的要求你要是同时开仿真、多个设备通信配置越高越好。系统方面Win10专业版或Win11专业版最省心。注意家庭版也能装但后续如果涉及到网络通信、组策略设置专业版可调项更多。另外CODESYS对中文用户名和中文安装路径支持不太好强烈建议你的Windows用户名用英文安装路径也用默认的C:\Program Files\CODESYS别自己改成中文目录。还有两条容易被忽略的检查项关闭杀毒软件或者加白名单。这不是玄学。CODESYS的Runtime组件、驱动服务在安装时会写系统服务和注册表部分杀毒软件会误报甚至直接隔离文件导致安装完成后软件能打开但无法连接设备。我至少帮同事处理过三次这类问题最后都是把CODESYS安装目录加入杀毒白名单解决的。系统盘剩余空间。CODESYS本身不大但后续装库、装插件、下载设备描述文件都会占用C盘空间。别看它安装包只有几百MB跑起来之后各种缓存和网关日志能把C盘慢慢蚕食掉。2.3 账号注册与下载源选择CODESYS官网下载需要注册账号这个流程是免费的填个邮箱、设个密码就行。注册时最好用企业邮箱或常用邮箱因为后续下载某些库文件或者获取试用授权官方会给这个邮箱发验证信息。下载时还会面临一个选择官方服务器还是国内镜像。如果直接访问官网慢可以用官方提供的中文站codesys.cn下载速度通常快很多。国内有些第三方网站也提供安装包下载但我建议能不用就不用——你无法保证那个安装包有没有被捆绑或者篡改这种要直接装进工控环境的软件还是走官方渠道稳妥。3. 安装与基础配置从安装包到能建工程的完整过程3.1 详细安装步骤以V3.5 SP19 64位完整版为例下载下来的文件一般是一个名为“CODESYS_V35_SP19_Setup.exe”之类的可执行文件双击开始安装。安装过程不难但有几个选项值得注意。第一步语言选择界面。这里选English或中文都可以这个只是安装程序的语言软件的界面语言后面可以在IDE里单独设置。不过说实话英文界面在查资料时更容易和网上教程对应起来中文界面则对新手友好。我自己的习惯是装英文界面因为很多报错信息英文搜起来方便。第二步安装路径选择。保持默认即可。千万不要装到中文路径下也不要为了“省C盘空间”装到D盘然后自己建个中文文件夹名后面各种路径错误会让人抓狂。第三步组件选择。完整版安装包会自动勾选大部分必要组件包括CODESYS Gateway网关、CODESYS Control Win V3软PLC运行时、PLC Recorder数据记录功能这个就是热搜里那个“plc-recorder读取codesys变量”功能的基础、各类库文件等。如果是自定义安装有几个组件我要重点提醒CODESYS Gateway必须装。这是PC与PLC通信的桥梁没有它你没法在线连接任何设备。CODESYS Control Win V3必须装。这是在你电脑上模拟出一个软PLC的运行时没有它你只能写代码不能本地仿真调试。CODESYS OPC UA Server看需求。如果你以后要做上位机数据采集这个值得装。设备描述文件Device Description默认会把主流厂家的设备都包含进去保持默认就好。第四步开始安装。这个过程会有进度条中间可能会弹出Windows安全提示询问是否允许安装设备驱动程序选择“安装”即可。等进度条走完会提示重启电脑建议照做。安装完成后桌面上会出现“CODESYS”快捷方式双击打开第一次启动大概需要几十秒因为它要初始化环境。然后就到了创建第一个工程的环节。3.2 第一次启动与工程创建打开CODESYS后你会看到一个类似Visual Studio的界面初次使用可能会有点懵菜单多、面板多、术语多。但没关系我们只做三件事。第一件事确认安装版本。点击菜单栏“Help - About”能看到完整的版本信息。如果上面显示V3.5 SP19说明安装成功。第二件事创建工程。点击“File - New Project”弹出对话框。在左边类别里选“Standard Project”标准工程右边输入工程名称和保存路径。注意工程名最好用英文路径不要有空格和中文。第三件事选择设备与编程语言。标准工程创建时会让你选择目标设备Device和编程语言。设备一栏如果找不到你手头的实际硬件可以先选“CODESYS Control Win V3”——这是本机仿真用的软PLC。编程语言选了ST结构化文本因为对新手来说ST比梯形图更接近通用编程思维而且后续上手其他语言也容易。进入工程界面后在左侧设备树里能看到你的工程结构。右键点击“Application”下的“PLC_PRG”主程序可以开始写第一行代码。比如输入一句IF bStart THEN xOutput : TRUE; END_IF然后点击菜单栏的“Login”登录按钮系统会提示是否下载程序到本地仿真PLC选择“是”。程序下载后再点“Start”启动按钮你就能看到变量监控面板里xOutput的状态变化了。到这里CODESYS的安装和基本配置就算跑通了。从下载到这一步顺利的话半小时以内能搞定。3.3 界面语言设置与工作环境优化前面说了安装时选英文但如果你确实觉得英文界面不顺手CODESYS是支持切中文的。菜单路径是“Tools - Options”在左侧找到“International Settings”把语言改成“Chinese (Simplified)”重启IDE就变成中文了。不过我要提醒一句中文界面虽然好懂但报错日志、库文件名称、帮助文档还是英文居多所以遇到查资料的时候尽量还是用英文关键词去搜索。除了语言还有几个配置项我建议新手一上来就改掉自动保存在“Options - Environment - Auto Save”里开启设置每5分钟自动保存一次。工程师的泪都是没保存时断电换来的。显示行号在“Options - Text Editor”里勾选显示行号。调试时报错会直接告诉你是第几行有行号定位快很多。快捷键习惯CODESYS的在线相关操作快捷键是“Login登录F8、Logout注销ShiftF8、Start启动F5、Stop停止ShiftF5”和博途这些软件不一样提前记住能省不少鼠标点击。3.4 授权与试用注册哪些功能免费哪些要花钱这是绕不开的话题。CODESYS的授权体系分两块IDE授权和Runtime授权。IDE授权指的是开发环境本身的授权。非商业用途的情况下CODESYS Development System本身是免费的你可以正常写代码、做仿真绝大多数功能不受限制。但如果你要用到某些高级功能库比如Motion运动控制库、CANopen协议栈、专业通信库这些库需要单独导入授权文件也就是.lib文件配合授权码否则编译时会报“许可证缺失”之类的错误。这三个功能库的使用授权官方提供“Demo License”演示授权通常是30-90天不等的试用期可以通过官网申请。具体路径是CODESYS官网首页 - Support - License - 选择对应库 - 填写设备信息 - 邮箱接收授权文件。安装授权文件的位置一般在C:\ProgramData\CODESYS\Licenses也可以直接在IDE里“Tools - License Manager”导入。Runtime授权则是部署到实际硬件控制器时买方需要购买的。每个控制器都绑定了唯一的运行授权厂家采购时已经包含了这项费用——这也是为什么虽然IDE免费但用CODESYS的硬件产品并不便宜的原因。重要提示你在网上可能会看到一些号称“永久授权”“破解版”的资源行业圈子就这么大我劝你不要碰。CODESYS的授权机制和硬件绑定有关联而且工业软件的法律风险远比个人软件高——更实际的原因是很多破解版会植入后门而工控环境里一旦PLC程序被动了手脚产线停摆的损失可能够买几百套正版。4. 核心功能配置网关、设备连接与符号导出4.1 CODESYS Gateway的配置与常见坑前面说Gateway必须安装那它到底干什么用你可以把它理解成一个“中间人”——IDE要连接各种PLC设备但不直接和PLC通信而是通过Gateway这个后台服务来收发数据。Gateway运行在你的电脑上作为一个常驻服务负责扫描网络上的CODESYS设备建立起IDE与设备之间的桥梁。配置一般的步骤是打开Windows服务管理器WinR输入services.msc找到“Codesys Gateway System Service”确认它的状态是“正在运行”。如果没运行右键启动。如果你改了安装路径或者换了电脑这里是第一个要排查的地方。打开CODESYS IDE菜单“Online - Communication Settings”在连接管理窗口里可以看到当前可用的网络接口和发现的设备。如果设备在网络上但没被发现要手动添加。点击窗口左下角的“Add”按钮选择“Ethernet”连接方式填入PLC的IP地址然后点“OK”。这里有一个很容易踩的坑Windows防火墙会把CODESYS Gateway的服务端口拦截掉。即使你在同一局域网内IDE也搜不到设备。处理方法是提前在防火墙的入站规则中把“CODESYS Gateway”相关的条目设为允许或者添加TCP 11740端口Gateway默认端口的入站规则。这个端口号建议记在笔记本上现场调试时频繁用到。还要注意如果你像很多工程师一样在虚拟机VMware里跑CODESYS开发环境连接外部PLC设备时会遇到“网络不可达”问题。虚拟机里的网络模式要设置为“桥接模式”让虚拟机和PLC在同一网段否则永远连不上设备。这一点和热搜词里“vmware”相关的疑问能对得上——不过虚拟机安装真的是另一个大坑后面有时间细讲。4.2 添加硬件设备为什么找不到你的PLC型号把PLC用网线连到电脑后在CODESYS的“Device”节点上点右键“Add Device”弹出设备选择窗口。在这个窗口里你能看到大量的设备厂商和型号如果找不到大概率是下面这几个原因。第一你要找的设备是“CODESYS V3”系列还是“V2.3”系列。老设备用的V2.3的Runtime在V3.5的IDE里是看不到的需要安装对应的设备描述文件或者在V2.3版本的IDE里开发。第二设备描述文件Device Description没装。如果你用的是国产CODESYS控制器厂商一般会提供一个安装包或一个.devdesc.xml描述文件在“Tools - Device Repository”里点击“Install”把这个文件导入设备才会出现在列表里。第三设备版本和IDE版本不匹配。比如设备描述文件是用SP17版本创建的你在SP19的IDE里打开可能兼容但如果跨度太大也会出现找不到或者编译报错。所以现场拿到一个新PLC第一件事是问厂家要“设备描述文件”不是问他们要编程软件别笑我见过很多工程师用CODESYS当万能钥匙买了一台PLC以为是免驱的。4.3 CODESYS Symbol配置与变量导出很多做上位机的人搜索“codesys符号配置”是因为要在LabVIEW、C#、Python或者组态软件里读写PLC变量。CODESYS里这项功能叫“Symbol Configuration”符号配置负责把PLC里的变量以统一的接口暴露给外部系统是OPC UA、Modbus TCP通信之外另一种非常常用的数据交换方式。配置步骤也不难在设备树中找到“Application”节点右键 - “Add Object” - “Symbol Configuration”。双击打开符号配置界面你会看到左边列出了工程里所有全局变量和POU变量。勾选你要对外暴露的变量或者直接勾选“Support OPC UA”选项让变量统一通过OPC UA暴露。如果上位机要用符号方式访问比如CODESYS自带的“CODESYS Symbolic”通信方式还要在“Options”里勾选“Support IEC 61131-3 symbols”。配置完成后重新编译并下载程序到PLC配置才会生效。有一个细节要提醒每次修改变量后都要重新生成符号配置否则上位机那边读到的还是旧的变量列表。有些项目里PLC和上位机同时启动上位机报“变量不存在”十有八九就是符号配置过期了——在IDE里右键符号配置节点选择“Rebuild All”再重新下载即可。4.4 PLC Recorder数据记录与数据库类库的位置搜索热词里有“plc-recorder读取codesys变量”和“codesys 数据库类库”其实这两个都属于CODESYS生态里的选装库功能安装环境时通常一并带上。PLC Recorder是CODESYS自带的数据记录组件可以在控制器运行期间把指定的变量按时间戳记录到本地存储文件CSV或XML格式或者通过FTP上传到上位机。非常适合做运行数据回溯、故障诊断。首次使用需要在设备树上添加Recorder对象然后配置采集周期、变量列表和存储路径算是比上位机轮巡更高效的采集方式。数据库类库则是让你在ST程序里直接连接MySQL、SQL Server等外部数据库——“mysql的alongwu第三方库(codesys)”里提到的“alongwu”其实是社区里一位开发者做的第三方开源库封装了常用的数据库操作。如果你要用它可以去CODESYS的官方库商店或者GitHub上搜索下载安装方式和普通库一样右键“Library Manager” - “Install library” - 选择Lib文件。注意第三方库的稳定性需要自行验证尤其是用于生产环境时必须做压力测试。官方每年都会更新一批库优先考虑官方库能省很多麻烦。5. 常见安装问题与排查技巧实录5.1 安装完成后IDE打不开或闪退这个问题排名最高也最让人崩溃。安装一切正常Windows也没报警但双击CODESYS图标后就是没反应或者闪一下就没下文。我归纳了三种最常见的情况情况一杀毒软件隔离了关键组件。前面说过CODESYS安装时会释放驱动服务和运行时组件部分杀毒软件会误报。排查方法是打开杀毒软件的隔离区看有没有CODESYS相关的文件被隔离如果有恢复文件并加入白名单。为省事起见安装前直接关闭实时防护装完以后再开是最稳的做法。情况二缺少.NET或VC运行库。CODESYS的IDE依赖.NET Framework和微软Visual C运行库新版系统一般自带但如果你的系统是精简版Ghost版可能缺。解决方案是在官网或者微软下载中心安装最新版本的.NET Framework 4.8和Visual C 2015-2022 Redistributable x64。情况三安装包损坏或安装路径冲突。重新下载安装包或者完全卸载后重装。卸载时不要只用Windows的“卸载程序”建议用官方卸载工具或者先把安装目录手动删除干净再清理注册表残留。5.2 提示“无法找到许可证”或“License Not Found”这个报错通常发生在编译时尤其是使用了Motion、CANopen等专业库。看到这个先别慌按以下顺序排查检查使用的库是否需要授权。在“Library Manager”里看库的“License”属性如果需要授权但没有导入授权文件就会报错。检查授权文件是否导入正确的路径。正常来说在“Tools - License Manager”里能看到已导入的授权。如果没有去官网申请试用授权文件注意申请时选对库版本。确认授权文件与电脑绑定。CODESYS的授权文件和电脑硬件信息绑定如果你换了电脑或者重装了系统授权会失效需要重新申请。5.3 PLC连接不上IP、防火墙、网线一个都不能少所有初学者都会遇到“登录失败”或者“设备无响应”。排查顺序应该是物理层网线插好了吗交换机/路由器指示灯亮吗PLC通电了吗链路层把电脑的IP改成和PLC同一网段比如PLC是192.168.1.10那电脑就设成192.168.1.xx不等于10子网掩码默认255.255.255.0。服务层确认Gateway服务在运行并且IDE的通信设置里选对了网络接口。如果你电脑上有多个网卡无线有线IDE可能默认选了错误的那张网卡。防火墙临时关闭Windows防火墙测试如果能连上就去防火墙高级设置里把Gateway的端口默认11740和IDE用的UDP端口放行。如果以上都做了还连不上教大家一个绝招用Wireshark或者系统自带的ping命令先测通不通。ping不通就是网络层面的问题ping通了还连不上那就是Gateway或者设备描述文件的问题——按数据中心那一节的方法逐项排查。5.4 常见的“编译报错”与“找不到库文件”CODESYS里新建工程后直接编译经常报“Library Manager: Device library not found”类似的错误。这是因为标准工程模板会自动引用一些设备相关的库而你的工程没有正确关联设备描述文件。处理方法是右键设备树里的“Device”节点选择“Update Device”重新加载设备描述或者在“Library Manager”里把红色的库删掉重新从库列表里添加合适的版本。还有一类报错是“Identifier expected”或“Unknown identifier”多是代码里的变量名打错了或者没声明。CODESYS的ST编辑器和高级语言一样严格变量必须先声明再使用定义在“VAR...END_VAR”之间。5.5 安装相关热搜词速查表这里把大家踩过的坑整理成一张速查表方便遇到问题时快速锁定方向现象可能原因解决建议IDE打不开/闪退杀毒隔离、缺.NET/VC库恢复隔离文件加白名单重装运行库编译报错找不到库设备描述文件未安装或库版本冲突右键Device节点Update Device重载库在线连接失败IP不匹配、防火墙拦截、Gateway未启动改IP同网段放行11740端口启动Gateway服务授权缺失未导入试用License或使用需要授权的库官网申请试用授权导入License Manager中文乱码或路径报错用户名或安装路径含中文使用英文系统用户名默认安装路径国产PLC型号找不到缺少设备描述文件向厂商获取devdesc.xml文件并导入Device Repository5.6 安装过程中的两个“反直觉”细节最后说两个我自己踩过、也帮别人排过很多次的细节。第一个是Windows系统更新和CODESYS的兼容性问题。Windows大版本更新后比如从Win10升级到Win11CODESYS的驱动程序和旧有的Runtime组件可能不兼容表现为仿真运行异常或者Gateway服务启动失败。遇到这种情况比较省力的做法是重装一遍CODESYS重装时它会更新驱动和Runtime组件通常能解决。第二个是不要把CODESYS安装在C盘以外的分区。我不是说技术上不行而是后面你会安装大量的第三方库、设备描述文件、授权文件它们默认路径都在C盘的ProgramData和用户目录下。如果你为了“省空间”把IDE本体装到D盘也不会省多少反而在权限、路径匹配上经常出幺蛾子。我见过最有意思的一次同事把软件装到D盘后Gateway服务怎么启动都失败后来才发现是因为D盘某个文件夹没有“Authenticated Users”的访问权限——这种问题排查起来极其费时间没必要自己制造麻烦。6. 环境验证与后续扩展思路6.1 用最小工程验证环境是否真的没问题安装完成后建议花五分钟做一个最小验证确保后续学习不走偏。新建一个标准工程设备选“CODESYS Control Win V3”语言选ST写一段最简单的逻辑一个定时器一秒翻转一次一个布尔变量。PROGRAM PLC_PRG VAR ton1 : TON; bToggle : BOOL; END_VAR ton1(IN : NOT ton1.Q, PT : T#1S); bToggle : ton1.Q;点击在线登录并下载程序启动后打开监视窗口能看到bToggle每秒钟从TRUE翻到FALSE再从FALSE翻到TRUE说明逻辑执行正常仿真Runtime没有问题。这一步既是验证安装也是第一次体验“在线监控”的工作方式。之后你可以试着改一下程序重新下载观察在线修改的流程——这个技能在现场调试时极其重要。6.2 从安装走向项目你可以把CODESYS用到哪里环境配好了下一步才真正开始有意思。给你几条实用扩展方向一是把CODESYS当成学习PLC编程的免费平台。不用买任何硬件靠本机仿真就能学会ST语言、梯形图、功能块图掌握定时器、计数器、PID等核心指令。这套知识迁移到西门子、三菱、汇川等主流PLC上几乎没有成本。二是结合OPC UA做上位机数据采集。前面配置好Symbol和OPC UA服务器然后用Python、C#、Node.js写一个上位机程序定时读取PLC里的变量做数据可视化或报警推送。现在工业数字化转型的项目很多这条路非常值钱。三是做运动控制或机器人控制。CODESYS的Motion功能库非常强大支持单轴、多轴、CNC、机器人控制配合支持CODESYS Runtime的伺服驱动器你可以在IDE里直接用SFC或ST编写运动控制程序完全替代传统的“PLC独立运动控制器”方案。四是研究PLC Recorder和数据库类库把PLC采集到的数据持久化到MySQL等数据库为后续数据分析提供原料。注意数据库类库的配置和授权问题第三方的“alongwu”库虽然好用但生产环境用前务必自行验证。6.3 学习资源与社区经验正式入坑后推荐几个靠谱的路径。一是CODESYS官方在线帮助文档Help - Documentation这是最好的查阅工具不要嫌英文烦基本上所有功能都能查到。二是CODESYS官网提供的在线技术论坛很多德国工程师和全球开发者都在上面回答问题搜报错信息时经常能搜到官方回复。三是B站、知乎以及国内工控社区的教程和案例中文环境下的实操经验对新手很友好。另外提一句如果你买的是汇川等国产基于CODESYS内核的PLC厂商的技术论坛和技术支持群通常更有针对性因为设备描述、固件版本这些信息和CODESYS官方是两条线。两个渠道配合使用问题基本都能解决。7. 安装这件事说到底是为后面的路做铺垫写到最后想分享一点个人体会。很多人把“安装软件”当成最简单的一步装完才发现连接不上设备、找不到库文件、授权过期光是环境问题就耗掉了大半天。实际上安装和配置这个环节直接决定了后面调试的顺畅程度——安装时偷的懒后面都要加倍还回去。我从第一次装CODESYS到现在前后在十几台电脑和不同控制器之间折腾过最大的一个心得就是面对安装报错不要慌先把“杀毒软件、防火墙、网络IP/网关/端口、设备描述文件、授权”这五个关键字过一遍百分之八十的问题都能解决。再剩下那百分之二十就是重装和换新版本——不是开玩笑CODESYS的版本迭代非常快有些顽固性兼容问题升一个SP版本就自己消失了。最后再分享一个小技巧每次装完CODESYS建议立即创建一个虚拟快照用VMware或者Windows系统还原点都行。这样哪天改库、装插件把环境搞坏了五分钟就能回滚到干净状态不需要把时间浪费在重新安装配置上。这个习惯比记住任何一条排查命令都值钱。 CODESYS安装配置完全指南：从下载到跑通第一个软PLC程序
1. 为什么要写这篇教程CODESYS到底解决了什么问题第一次接触CODESYS的人多半是听同行提起“这个软件能做软PLC”“写逻辑跟玩一样”。我当时入坑是因为接手一个项目客户指定要用支持IEC 61131-3标准的控制器而且最好能在一台普通工控机上直接跑逻辑不想再被某个品牌的专用编程软件捆绑。折腾了整整一个下午从下载到跑通第一个程序中间踩的坑说多不多说少也够写一篇长文了——所以这篇就是冲着让你少走弯路来的。先说CODESYS是什么。它是德国3S公司推出的工业控制器编程开发环境基于IEC 61131-3国际标准支持ST结构化文本、LD梯形图、FBD功能块图、SFC顺序功能图、CFC连续功能图等全套PLC编程语言。你可以把它理解成“PLC界的Visual Studio”——它不绑定特定硬件只要你买的控制器支持CODESYS RuntimeCODESYS的运行时内核就能用同一套开发环境写逻辑、调试、下载、监控。这里要重点说一句CODESYS和传统PLC编程软件最大的区别在哪里。传统方式比如西门子的博途、三菱的GX Works软件和硬件是绑死的CODESYS则把“编程工具”和“运行内核”拆开了。你在PC上装的是IDE开发环境控制器里跑的是Runtime运行时两边通过网络或串口通信。这意味着什么意味着只要硬件厂商预装了CODESYS Runtime不管是国产PLC、进口控制器还是你自己做的嵌入式板卡都能用同一个开发环境写程序。像汇川、信捷、禾川等不少国产厂商的中大型PLC底层用的就是CODESYS内核这也是为什么“汇川PLC codesys”会成为热搜词。这篇文章适合谁如果你是自动化工程师、电气工程师、院校学生或者做设备集成的自由职业者只要你想学软PLC或基于CODESYS的控制器编程这篇就能帮你从零打通“下载到配置”这一关。内容会细致到什么程度下载哪个包、装哪个组件、环境变量怎么配、常见报错怎么处理全部覆盖。2. 安装前的准备工作版本选型与系统环境检查2.1 搞清楚自己该装哪个版本这是我见过最多人卡住的第一步。打开CODESYS官网下载页面你会发现版本多得让人眼花缭乱CODESYS V2.3、CODESYS V3.5 SP17、SP18、SP19、SP20……还有所谓的“Development”开发版和“Full”完整版之分如果不提前搞清楚随便下了一个就能把你带沟里。先说结论现在学优先选CODESYS V3.5 SP19及以上版本64位安装包。为什么V2.3是2000年代的老古董虽然界面简单但和现代控制器的兼容性已经跟不上官方早就转向V3系列。V3.5的SP版本相当于迭代补丁包SP19以后的版本对Win10/Win11系统支持更好自带的各种功能库也更全。至于SP20、SP21那是后续的更新版如果你用的控制器厂商要求特定SP版本按厂商要求来没有要求就装最新的没毛病。再说开发版和完整版的区别。官网下载时会让你选“CODESYS Development System”有时也叫试用版和“CODESYS Full Installation”。开发版是核心IDE本体免费使用但部分库和功能需要单独安装完整版把常见的库、工具、在线帮助都打包在一起省心但安装包更大。我的建议是初学选完整版因为省得后面缺一个库又回头找安装包。注意CODESYS虽然免费但它不是开源软件。免费的是“非商业用途的开发环境”如果你要把程序部署到商业产品上需要购买对应的Runtime授权。这个后面会细说。2.2 系统要求与安装前的环境准备CODESYS对电脑的要求不算高但有几个细节一定要提前处理不然装一半报错或者装完打不开心态直接崩。硬件配置方面建议至少4GB内存8GB更舒服、i3及以上CPU、20GB可用磁盘空间。这只是运行IDE的要求你要是同时开仿真、多个设备通信配置越高越好。系统方面Win10专业版或Win11专业版最省心。注意家庭版也能装但后续如果涉及到网络通信、组策略设置专业版可调项更多。另外CODESYS对中文用户名和中文安装路径支持不太好强烈建议你的Windows用户名用英文安装路径也用默认的C:\Program Files\CODESYS别自己改成中文目录。还有两条容易被忽略的检查项关闭杀毒软件或者加白名单。这不是玄学。CODESYS的Runtime组件、驱动服务在安装时会写系统服务和注册表部分杀毒软件会误报甚至直接隔离文件导致安装完成后软件能打开但无法连接设备。我至少帮同事处理过三次这类问题最后都是把CODESYS安装目录加入杀毒白名单解决的。系统盘剩余空间。CODESYS本身不大但后续装库、装插件、下载设备描述文件都会占用C盘空间。别看它安装包只有几百MB跑起来之后各种缓存和网关日志能把C盘慢慢蚕食掉。2.3 账号注册与下载源选择CODESYS官网下载需要注册账号这个流程是免费的填个邮箱、设个密码就行。注册时最好用企业邮箱或常用邮箱因为后续下载某些库文件或者获取试用授权官方会给这个邮箱发验证信息。下载时还会面临一个选择官方服务器还是国内镜像。如果直接访问官网慢可以用官方提供的中文站codesys.cn下载速度通常快很多。国内有些第三方网站也提供安装包下载但我建议能不用就不用——你无法保证那个安装包有没有被捆绑或者篡改这种要直接装进工控环境的软件还是走官方渠道稳妥。3. 安装与基础配置从安装包到能建工程的完整过程3.1 详细安装步骤以V3.5 SP19 64位完整版为例下载下来的文件一般是一个名为“CODESYS_V35_SP19_Setup.exe”之类的可执行文件双击开始安装。安装过程不难但有几个选项值得注意。第一步语言选择界面。这里选English或中文都可以这个只是安装程序的语言软件的界面语言后面可以在IDE里单独设置。不过说实话英文界面在查资料时更容易和网上教程对应起来中文界面则对新手友好。我自己的习惯是装英文界面因为很多报错信息英文搜起来方便。第二步安装路径选择。保持默认即可。千万不要装到中文路径下也不要为了“省C盘空间”装到D盘然后自己建个中文文件夹名后面各种路径错误会让人抓狂。第三步组件选择。完整版安装包会自动勾选大部分必要组件包括CODESYS Gateway网关、CODESYS Control Win V3软PLC运行时、PLC Recorder数据记录功能这个就是热搜里那个“plc-recorder读取codesys变量”功能的基础、各类库文件等。如果是自定义安装有几个组件我要重点提醒CODESYS Gateway必须装。这是PC与PLC通信的桥梁没有它你没法在线连接任何设备。CODESYS Control Win V3必须装。这是在你电脑上模拟出一个软PLC的运行时没有它你只能写代码不能本地仿真调试。CODESYS OPC UA Server看需求。如果你以后要做上位机数据采集这个值得装。设备描述文件Device Description默认会把主流厂家的设备都包含进去保持默认就好。第四步开始安装。这个过程会有进度条中间可能会弹出Windows安全提示询问是否允许安装设备驱动程序选择“安装”即可。等进度条走完会提示重启电脑建议照做。安装完成后桌面上会出现“CODESYS”快捷方式双击打开第一次启动大概需要几十秒因为它要初始化环境。然后就到了创建第一个工程的环节。3.2 第一次启动与工程创建打开CODESYS后你会看到一个类似Visual Studio的界面初次使用可能会有点懵菜单多、面板多、术语多。但没关系我们只做三件事。第一件事确认安装版本。点击菜单栏“Help - About”能看到完整的版本信息。如果上面显示V3.5 SP19说明安装成功。第二件事创建工程。点击“File - New Project”弹出对话框。在左边类别里选“Standard Project”标准工程右边输入工程名称和保存路径。注意工程名最好用英文路径不要有空格和中文。第三件事选择设备与编程语言。标准工程创建时会让你选择目标设备Device和编程语言。设备一栏如果找不到你手头的实际硬件可以先选“CODESYS Control Win V3”——这是本机仿真用的软PLC。编程语言选了ST结构化文本因为对新手来说ST比梯形图更接近通用编程思维而且后续上手其他语言也容易。进入工程界面后在左侧设备树里能看到你的工程结构。右键点击“Application”下的“PLC_PRG”主程序可以开始写第一行代码。比如输入一句IF bStart THEN xOutput : TRUE; END_IF然后点击菜单栏的“Login”登录按钮系统会提示是否下载程序到本地仿真PLC选择“是”。程序下载后再点“Start”启动按钮你就能看到变量监控面板里xOutput的状态变化了。到这里CODESYS的安装和基本配置就算跑通了。从下载到这一步顺利的话半小时以内能搞定。3.3 界面语言设置与工作环境优化前面说了安装时选英文但如果你确实觉得英文界面不顺手CODESYS是支持切中文的。菜单路径是“Tools - Options”在左侧找到“International Settings”把语言改成“Chinese (Simplified)”重启IDE就变成中文了。不过我要提醒一句中文界面虽然好懂但报错日志、库文件名称、帮助文档还是英文居多所以遇到查资料的时候尽量还是用英文关键词去搜索。除了语言还有几个配置项我建议新手一上来就改掉自动保存在“Options - Environment - Auto Save”里开启设置每5分钟自动保存一次。工程师的泪都是没保存时断电换来的。显示行号在“Options - Text Editor”里勾选显示行号。调试时报错会直接告诉你是第几行有行号定位快很多。快捷键习惯CODESYS的在线相关操作快捷键是“Login登录F8、Logout注销ShiftF8、Start启动F5、Stop停止ShiftF5”和博途这些软件不一样提前记住能省不少鼠标点击。3.4 授权与试用注册哪些功能免费哪些要花钱这是绕不开的话题。CODESYS的授权体系分两块IDE授权和Runtime授权。IDE授权指的是开发环境本身的授权。非商业用途的情况下CODESYS Development System本身是免费的你可以正常写代码、做仿真绝大多数功能不受限制。但如果你要用到某些高级功能库比如Motion运动控制库、CANopen协议栈、专业通信库这些库需要单独导入授权文件也就是.lib文件配合授权码否则编译时会报“许可证缺失”之类的错误。这三个功能库的使用授权官方提供“Demo License”演示授权通常是30-90天不等的试用期可以通过官网申请。具体路径是CODESYS官网首页 - Support - License - 选择对应库 - 填写设备信息 - 邮箱接收授权文件。安装授权文件的位置一般在C:\ProgramData\CODESYS\Licenses也可以直接在IDE里“Tools - License Manager”导入。Runtime授权则是部署到实际硬件控制器时买方需要购买的。每个控制器都绑定了唯一的运行授权厂家采购时已经包含了这项费用——这也是为什么虽然IDE免费但用CODESYS的硬件产品并不便宜的原因。重要提示你在网上可能会看到一些号称“永久授权”“破解版”的资源行业圈子就这么大我劝你不要碰。CODESYS的授权机制和硬件绑定有关联而且工业软件的法律风险远比个人软件高——更实际的原因是很多破解版会植入后门而工控环境里一旦PLC程序被动了手脚产线停摆的损失可能够买几百套正版。4. 核心功能配置网关、设备连接与符号导出4.1 CODESYS Gateway的配置与常见坑前面说Gateway必须安装那它到底干什么用你可以把它理解成一个“中间人”——IDE要连接各种PLC设备但不直接和PLC通信而是通过Gateway这个后台服务来收发数据。Gateway运行在你的电脑上作为一个常驻服务负责扫描网络上的CODESYS设备建立起IDE与设备之间的桥梁。配置一般的步骤是打开Windows服务管理器WinR输入services.msc找到“Codesys Gateway System Service”确认它的状态是“正在运行”。如果没运行右键启动。如果你改了安装路径或者换了电脑这里是第一个要排查的地方。打开CODESYS IDE菜单“Online - Communication Settings”在连接管理窗口里可以看到当前可用的网络接口和发现的设备。如果设备在网络上但没被发现要手动添加。点击窗口左下角的“Add”按钮选择“Ethernet”连接方式填入PLC的IP地址然后点“OK”。这里有一个很容易踩的坑Windows防火墙会把CODESYS Gateway的服务端口拦截掉。即使你在同一局域网内IDE也搜不到设备。处理方法是提前在防火墙的入站规则中把“CODESYS Gateway”相关的条目设为允许或者添加TCP 11740端口Gateway默认端口的入站规则。这个端口号建议记在笔记本上现场调试时频繁用到。还要注意如果你像很多工程师一样在虚拟机VMware里跑CODESYS开发环境连接外部PLC设备时会遇到“网络不可达”问题。虚拟机里的网络模式要设置为“桥接模式”让虚拟机和PLC在同一网段否则永远连不上设备。这一点和热搜词里“vmware”相关的疑问能对得上——不过虚拟机安装真的是另一个大坑后面有时间细讲。4.2 添加硬件设备为什么找不到你的PLC型号把PLC用网线连到电脑后在CODESYS的“Device”节点上点右键“Add Device”弹出设备选择窗口。在这个窗口里你能看到大量的设备厂商和型号如果找不到大概率是下面这几个原因。第一你要找的设备是“CODESYS V3”系列还是“V2.3”系列。老设备用的V2.3的Runtime在V3.5的IDE里是看不到的需要安装对应的设备描述文件或者在V2.3版本的IDE里开发。第二设备描述文件Device Description没装。如果你用的是国产CODESYS控制器厂商一般会提供一个安装包或一个.devdesc.xml描述文件在“Tools - Device Repository”里点击“Install”把这个文件导入设备才会出现在列表里。第三设备版本和IDE版本不匹配。比如设备描述文件是用SP17版本创建的你在SP19的IDE里打开可能兼容但如果跨度太大也会出现找不到或者编译报错。所以现场拿到一个新PLC第一件事是问厂家要“设备描述文件”不是问他们要编程软件别笑我见过很多工程师用CODESYS当万能钥匙买了一台PLC以为是免驱的。4.3 CODESYS Symbol配置与变量导出很多做上位机的人搜索“codesys符号配置”是因为要在LabVIEW、C#、Python或者组态软件里读写PLC变量。CODESYS里这项功能叫“Symbol Configuration”符号配置负责把PLC里的变量以统一的接口暴露给外部系统是OPC UA、Modbus TCP通信之外另一种非常常用的数据交换方式。配置步骤也不难在设备树中找到“Application”节点右键 - “Add Object” - “Symbol Configuration”。双击打开符号配置界面你会看到左边列出了工程里所有全局变量和POU变量。勾选你要对外暴露的变量或者直接勾选“Support OPC UA”选项让变量统一通过OPC UA暴露。如果上位机要用符号方式访问比如CODESYS自带的“CODESYS Symbolic”通信方式还要在“Options”里勾选“Support IEC 61131-3 symbols”。配置完成后重新编译并下载程序到PLC配置才会生效。有一个细节要提醒每次修改变量后都要重新生成符号配置否则上位机那边读到的还是旧的变量列表。有些项目里PLC和上位机同时启动上位机报“变量不存在”十有八九就是符号配置过期了——在IDE里右键符号配置节点选择“Rebuild All”再重新下载即可。4.4 PLC Recorder数据记录与数据库类库的位置搜索热词里有“plc-recorder读取codesys变量”和“codesys 数据库类库”其实这两个都属于CODESYS生态里的选装库功能安装环境时通常一并带上。PLC Recorder是CODESYS自带的数据记录组件可以在控制器运行期间把指定的变量按时间戳记录到本地存储文件CSV或XML格式或者通过FTP上传到上位机。非常适合做运行数据回溯、故障诊断。首次使用需要在设备树上添加Recorder对象然后配置采集周期、变量列表和存储路径算是比上位机轮巡更高效的采集方式。数据库类库则是让你在ST程序里直接连接MySQL、SQL Server等外部数据库——“mysql的alongwu第三方库(codesys)”里提到的“alongwu”其实是社区里一位开发者做的第三方开源库封装了常用的数据库操作。如果你要用它可以去CODESYS的官方库商店或者GitHub上搜索下载安装方式和普通库一样右键“Library Manager” - “Install library” - 选择Lib文件。注意第三方库的稳定性需要自行验证尤其是用于生产环境时必须做压力测试。官方每年都会更新一批库优先考虑官方库能省很多麻烦。5. 常见安装问题与排查技巧实录5.1 安装完成后IDE打不开或闪退这个问题排名最高也最让人崩溃。安装一切正常Windows也没报警但双击CODESYS图标后就是没反应或者闪一下就没下文。我归纳了三种最常见的情况情况一杀毒软件隔离了关键组件。前面说过CODESYS安装时会释放驱动服务和运行时组件部分杀毒软件会误报。排查方法是打开杀毒软件的隔离区看有没有CODESYS相关的文件被隔离如果有恢复文件并加入白名单。为省事起见安装前直接关闭实时防护装完以后再开是最稳的做法。情况二缺少.NET或VC运行库。CODESYS的IDE依赖.NET Framework和微软Visual C运行库新版系统一般自带但如果你的系统是精简版Ghost版可能缺。解决方案是在官网或者微软下载中心安装最新版本的.NET Framework 4.8和Visual C 2015-2022 Redistributable x64。情况三安装包损坏或安装路径冲突。重新下载安装包或者完全卸载后重装。卸载时不要只用Windows的“卸载程序”建议用官方卸载工具或者先把安装目录手动删除干净再清理注册表残留。5.2 提示“无法找到许可证”或“License Not Found”这个报错通常发生在编译时尤其是使用了Motion、CANopen等专业库。看到这个先别慌按以下顺序排查检查使用的库是否需要授权。在“Library Manager”里看库的“License”属性如果需要授权但没有导入授权文件就会报错。检查授权文件是否导入正确的路径。正常来说在“Tools - License Manager”里能看到已导入的授权。如果没有去官网申请试用授权文件注意申请时选对库版本。确认授权文件与电脑绑定。CODESYS的授权文件和电脑硬件信息绑定如果你换了电脑或者重装了系统授权会失效需要重新申请。5.3 PLC连接不上IP、防火墙、网线一个都不能少所有初学者都会遇到“登录失败”或者“设备无响应”。排查顺序应该是物理层网线插好了吗交换机/路由器指示灯亮吗PLC通电了吗链路层把电脑的IP改成和PLC同一网段比如PLC是192.168.1.10那电脑就设成192.168.1.xx不等于10子网掩码默认255.255.255.0。服务层确认Gateway服务在运行并且IDE的通信设置里选对了网络接口。如果你电脑上有多个网卡无线有线IDE可能默认选了错误的那张网卡。防火墙临时关闭Windows防火墙测试如果能连上就去防火墙高级设置里把Gateway的端口默认11740和IDE用的UDP端口放行。如果以上都做了还连不上教大家一个绝招用Wireshark或者系统自带的ping命令先测通不通。ping不通就是网络层面的问题ping通了还连不上那就是Gateway或者设备描述文件的问题——按数据中心那一节的方法逐项排查。5.4 常见的“编译报错”与“找不到库文件”CODESYS里新建工程后直接编译经常报“Library Manager: Device library not found”类似的错误。这是因为标准工程模板会自动引用一些设备相关的库而你的工程没有正确关联设备描述文件。处理方法是右键设备树里的“Device”节点选择“Update Device”重新加载设备描述或者在“Library Manager”里把红色的库删掉重新从库列表里添加合适的版本。还有一类报错是“Identifier expected”或“Unknown identifier”多是代码里的变量名打错了或者没声明。CODESYS的ST编辑器和高级语言一样严格变量必须先声明再使用定义在“VAR...END_VAR”之间。5.5 安装相关热搜词速查表这里把大家踩过的坑整理成一张速查表方便遇到问题时快速锁定方向现象可能原因解决建议IDE打不开/闪退杀毒隔离、缺.NET/VC库恢复隔离文件加白名单重装运行库编译报错找不到库设备描述文件未安装或库版本冲突右键Device节点Update Device重载库在线连接失败IP不匹配、防火墙拦截、Gateway未启动改IP同网段放行11740端口启动Gateway服务授权缺失未导入试用License或使用需要授权的库官网申请试用授权导入License Manager中文乱码或路径报错用户名或安装路径含中文使用英文系统用户名默认安装路径国产PLC型号找不到缺少设备描述文件向厂商获取devdesc.xml文件并导入Device Repository5.6 安装过程中的两个“反直觉”细节最后说两个我自己踩过、也帮别人排过很多次的细节。第一个是Windows系统更新和CODESYS的兼容性问题。Windows大版本更新后比如从Win10升级到Win11CODESYS的驱动程序和旧有的Runtime组件可能不兼容表现为仿真运行异常或者Gateway服务启动失败。遇到这种情况比较省力的做法是重装一遍CODESYS重装时它会更新驱动和Runtime组件通常能解决。第二个是不要把CODESYS安装在C盘以外的分区。我不是说技术上不行而是后面你会安装大量的第三方库、设备描述文件、授权文件它们默认路径都在C盘的ProgramData和用户目录下。如果你为了“省空间”把IDE本体装到D盘也不会省多少反而在权限、路径匹配上经常出幺蛾子。我见过最有意思的一次同事把软件装到D盘后Gateway服务怎么启动都失败后来才发现是因为D盘某个文件夹没有“Authenticated Users”的访问权限——这种问题排查起来极其费时间没必要自己制造麻烦。6. 环境验证与后续扩展思路6.1 用最小工程验证环境是否真的没问题安装完成后建议花五分钟做一个最小验证确保后续学习不走偏。新建一个标准工程设备选“CODESYS Control Win V3”语言选ST写一段最简单的逻辑一个定时器一秒翻转一次一个布尔变量。PROGRAM PLC_PRG VAR ton1 : TON; bToggle : BOOL; END_VAR ton1(IN : NOT ton1.Q, PT : T#1S); bToggle : ton1.Q;点击在线登录并下载程序启动后打开监视窗口能看到bToggle每秒钟从TRUE翻到FALSE再从FALSE翻到TRUE说明逻辑执行正常仿真Runtime没有问题。这一步既是验证安装也是第一次体验“在线监控”的工作方式。之后你可以试着改一下程序重新下载观察在线修改的流程——这个技能在现场调试时极其重要。6.2 从安装走向项目你可以把CODESYS用到哪里环境配好了下一步才真正开始有意思。给你几条实用扩展方向一是把CODESYS当成学习PLC编程的免费平台。不用买任何硬件靠本机仿真就能学会ST语言、梯形图、功能块图掌握定时器、计数器、PID等核心指令。这套知识迁移到西门子、三菱、汇川等主流PLC上几乎没有成本。二是结合OPC UA做上位机数据采集。前面配置好Symbol和OPC UA服务器然后用Python、C#、Node.js写一个上位机程序定时读取PLC里的变量做数据可视化或报警推送。现在工业数字化转型的项目很多这条路非常值钱。三是做运动控制或机器人控制。CODESYS的Motion功能库非常强大支持单轴、多轴、CNC、机器人控制配合支持CODESYS Runtime的伺服驱动器你可以在IDE里直接用SFC或ST编写运动控制程序完全替代传统的“PLC独立运动控制器”方案。四是研究PLC Recorder和数据库类库把PLC采集到的数据持久化到MySQL等数据库为后续数据分析提供原料。注意数据库类库的配置和授权问题第三方的“alongwu”库虽然好用但生产环境用前务必自行验证。6.3 学习资源与社区经验正式入坑后推荐几个靠谱的路径。一是CODESYS官方在线帮助文档Help - Documentation这是最好的查阅工具不要嫌英文烦基本上所有功能都能查到。二是CODESYS官网提供的在线技术论坛很多德国工程师和全球开发者都在上面回答问题搜报错信息时经常能搜到官方回复。三是B站、知乎以及国内工控社区的教程和案例中文环境下的实操经验对新手很友好。另外提一句如果你买的是汇川等国产基于CODESYS内核的PLC厂商的技术论坛和技术支持群通常更有针对性因为设备描述、固件版本这些信息和CODESYS官方是两条线。两个渠道配合使用问题基本都能解决。7. 安装这件事说到底是为后面的路做铺垫写到最后想分享一点个人体会。很多人把“安装软件”当成最简单的一步装完才发现连接不上设备、找不到库文件、授权过期光是环境问题就耗掉了大半天。实际上安装和配置这个环节直接决定了后面调试的顺畅程度——安装时偷的懒后面都要加倍还回去。我从第一次装CODESYS到现在前后在十几台电脑和不同控制器之间折腾过最大的一个心得就是面对安装报错不要慌先把“杀毒软件、防火墙、网络IP/网关/端口、设备描述文件、授权”这五个关键字过一遍百分之八十的问题都能解决。再剩下那百分之二十就是重装和换新版本——不是开玩笑CODESYS的版本迭代非常快有些顽固性兼容问题升一个SP版本就自己消失了。最后再分享一个小技巧每次装完CODESYS建议立即创建一个虚拟快照用VMware或者Windows系统还原点都行。这样哪天改库、装插件把环境搞坏了五分钟就能回滚到干净状态不需要把时间浪费在重新安装配置上。这个习惯比记住任何一条排查命令都值钱。