开发环境搭建：跨平台工具链选择

说实话，做工业通信开发这么多年，我踩过最大的坑就是环境不一致。你在Windows上跑得好好的代码，拿到Linux工控机上就崩了。所以这次咱们搭建环境，我坚持一个原则：一次搭建，到处编译。

说白了，就是选一套跨平台的工具链。我个人习惯用VS Code + CMake + MinGW/GCC这套组合。为什么？因为轻量、灵活、不绑定任何IDE。你想想看，如果哪天客户要求你用国产系统，这套方案几乎零成本迁移。

VS Code：不只是编辑器

VS Code其实是个披着编辑器外衣的开发平台。我刚开始用的时候也觉得它花里胡哨，后来发现插件生态是真香。

你需要装这几个插件：

• C/C++（微软官方那个）——代码补全和调试必备
• CMake Tools——让CMake在VS Code里可视化操作
• GitLens——看代码历史改动的神器
• Hex Editor——调试Modbus报文时直接看二进制

CMake：告别Makefile手写时代

CMake这东西，说白了就是生成Makefile的生成器。你写一个CMakeLists.txt，它就能自动适配Windows、Linux、macOS的编译器。

我见过太多新手直接手写Makefile，结果换个平台就报错。用CMake吧，省心。

一个最简单的CMakeLists.txt长这样：

cmake_minimum_required(VERSION 3.10)
project(ModbusMaster)

set(CMAKE_C_STANDARD 11)
set(CMAKE_CXX_STANDARD 17)

# 找libmodbus库
find_package(PkgConfig REQUIRED)
pkg_check_modules(LIBMODBUS REQUIRED libmodbus)

add_executable(modbus_master main.c)
target_link_libraries(modbus_master ${LIBMODBUS_LIBRARIES})
target_include_directories(modbus_master PRIVATE ${LIBMODBUS_INCLUDE_DIRS})

嗯，这里要注意：find_package那行，如果libmodbus没装到系统默认路径，你得手动设置PKG_CONFIG_PATH环境变量。我曾经因为这个折腾了一下午。

MinGW vs GCC：选哪个？

如果你在Windows上开发，用MinGW-w64。如果你在Linux上，系统自带的GCC就行。

为什么推荐MinGW？因为它是原生Windows程序，不需要Cygwin那套模拟层。我实测过，同样的代码，MinGW编译出来的程序比Cygwin快15%左右。

安装步骤很简单：

1. 去MinGW-w64官网下载安装包
2. 选架构：x86_64（64位）或i686（32位）
3. 选线程模型：posix（推荐）或win32
4. 把bin目录加到系统PATH里

libmodbus库：源码编译与安装

libmodbus是Modbus协议的事实标准库。我建议你从源码编译，而不是用包管理器安装。为什么？因为你可以定制编译选项，比如去掉不需要的从站功能，减小库体积。

编译步骤：

# 下载源码
git clone https://github.com/stephane/libmodbus.git
cd libmodbus

# 配置（这里可以加选项）
./autogen.sh
./configure --prefix=/usr/local --enable-static --disable-shared

# 编译并安装
make -j4
sudo make install

几个关键选项说明：

选项	作用	我的建议
--enable-static	编译静态库	推荐，部署时不用带动态库
--disable-shared	不编译动态库	嵌入式场景推荐
--with-gnu-ld	使用GNU链接器	Linux下默认开启

安装完成后，验证一下：

pkg-config --libs --cflags libmodbus
# 应该输出类似：
# -I/usr/local/include/modbus -L/usr/local/lib -lmodbus

Python minimalmodbus：快速验证的利器

有时候你不想写C代码，就想快速验证一下Modbus设备能不能通。这时候Python的minimalmodbus库就派上用场了。

安装就一句话：

pip install minimalmodbus

然后你就可以用几行代码读寄存器了：

import minimalmodbus

# 连接设备（串口、从站地址）
instrument = minimalmodbus.Instrument('COM3', 1)
instrument.serial.baudrate = 9600
instrument.serial.timeout = 0.5

# 读取保持寄存器（地址0，数量2）
values = instrument.read_registers(0, 2)
print(f"寄存器值: {values}")

你看，是不是很简单？我经常用这个库做现场调试。先拿Python脚本测通，再用C代码做正式开发。这样能省下大量排查通信问题的时间。

本章知识体系

下面这张图是我自己画的，把整个环境搭建的逻辑串起来了：

这张图把三个核心模块的关系说清楚了。工具链是基础，libmodbus是主力，minimalmodbus是辅助。三者配合，能覆盖从原型验证到产品交付的全流程。

好了，环境搭建就到这里。记住：工欲善其事，必先利其器。花点时间把环境配好，后面写代码会顺畅很多。

---

公众号:蓝海资料掘金营，微信deep3321