直接用 boost::crc_16_type 会出错，因为 modbus crc16 要求初始值为 0xffff、多项式为 0x8005、不取反输入和输出，而 boost 默认配置不满足这四点。
为什么直接用 boost::crc_16_type 会出错？
MODBUS 的 CRC16 不是标准 CRC-16-IBM（即常见 boost::crc_16_type），它有四个关键差异：初始值为 0xFFFF、不取反输入、不取反输出、多项式为 0x8005。直接套用 Boost 默认配置会得到错误结果，尤其在和 PLC 或 RTU 设备通信时校验失败。
常见错误现象：read_holding_registers 响应被设备丢弃、串口抓包显示 CRC 字节不匹配、自己算的 CRC 和 Modbus Poll 工具结果对不上。
- 必须手动指定多项式
0x8005，而非默认0x8005的变体（如0xA001是其逆序，不能混用） - 初始余数必须设为
0xFFFF，不能是0x0000 - 输入字节需按原始顺序逐字节处理（高位在前，即大端顺序），不能翻转字节或位
- 最终结果不异或
0xFFFF，也不做任何后处理
手写查表法实现（推荐用于嵌入式或性能敏感场景）
查表法比逐位计算快 5–10 倍，且代码可控、无第三方依赖。核心是预生成 256 元素的 CRC 表，每项对应一个字节输入后的余数更新结果。
关键注意点：表生成时必须严格按 MODBUS 规则——初始余数 0x0000，左移 8 次，每次判断最高位是否为 1，再异或 0x8005；但注意：这是“计算表”的过程，不是“校验时”的流程。
static const uint16_t crc16_table[256] = {
0x0000, 0xC0C1, 0xC181, 0x0140, /* ... 省略，共 256 项 */
/* 实际使用时建议用脚本生成，避免手写错误 */
};
- 查表前将初始余数设为
0xFFFF - 对每个输入字节
b：取crc ^ b的低 8 位作表索引，再将crc右移 8 位，最后异或查得的表值 - 最终返回
crc，不反转高低字节 —— MODBUS 要求低位字节在前（little-endian 传输顺序），但计算值本身是整数，发送时需拆成uint8_t(crc & 0xFF)和uint8_t(crc >> 8)
用 std::span<const uint8_t></const> 封装输入更安全
传原始指针 + 长度容易越界或长度错配，尤其读文件后用 std::vector<uint8_t>::data()</uint8_t> 时若 vector 被移动，指针失效。用 std::span（C++20）或退化为 std::vector<uint8_t>&</uint8_t> 更可靠。
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
示例调用：
std::vector<uint8_t> buf = read_file("modbus_cmd.bin");
uint16_t crc = calc_crc16_modbus(std::span<const uint8_t>(buf));</const></uint8_t>
- 函数签名建议为
uint16_t calc_crc16_modbus(std::span<const uint8_t> data)</const> - 如果必须支持 C++17，可用
gsl::span或自定义轻量 wrapper，避免裸指针 - 文件读取务必用二进制模式（
std::ios::binary），否则 Windows 下\r\n转换会破坏原始字节流
验证结果：用已知 Modbus 报文交叉核对
别只靠“算出来不报错”就认为对了。最稳妥方式是找一条公开的、带 CRC 的 Modbus RTU 报文，比如：
<code>01 03 00 00 00 02</code> → 应得 CRC <code>72 31</code>（小端：0x3172）
注意：这个报文不含 CRC 字节本身，CRC 是对前面所有字节（地址+功能码+数据）计算得出的两个字节，低位在前。
- 把这 6 字节喂给你的函数，检查返回值是否等于
0x3172 - 再试一条含异常响应的：例如
01 83 02（地址 1，功能码 131，异常码 2），CRC 应为C9 38（即0x38C9） - 如果结果高位/低位颠倒，大概率是发送时字节序搞反了，不是算法错
Modbus CRC 看似简单，但初始化值、多项式方向、输入/输出是否取反这四点只要错一个，结果就全错。实际调试时，优先打印中间每一步的余数值，比盲猜高效得多。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
