Qt 实现 CRC 循环冗余校验工具：从原理到代码实现

原创 已于 2025-06-25 14:34:17 修改 · 1k 阅读 · 17 ·
本内容遵循CC 4.0 BY-SA版权协议
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
GEO检测
标签
#qt #开发语言
于 2025-06-25 14:25:50 首次发布

在数据通信和存储领域，错误检测是保证数据完整性的重要环节。CRC（循环冗余校验）作为一种高效的错误检测算法，被广泛应用于各种通信协议和存储介质中。在最近的工作过程中，刚好被接收到了编写一个CRC校验工具的任务，那么刚好发表一下如何使用 Qt 框架实现一个功能完善的 CRC 计算工具这篇文章，因为时间有限所以只编写了16进制的所有计算方法。

CRC 算法原理概述

CRC（Cyclic Redundancy Check）循环冗余校验是一种通过数学运算来检测数据传输或存储中错误的方法。其核心原理是：

  1. 选择一个生成多项式 G (x)（对应代码中的 poly 参数）
  2. 将原始数据视为一个二进制数 D (x)
  3. 通过模 2 除法计算 D (x) * x^n / G (x) 的余数 R (x)（n 为多项式的次数）
  4. 将余数 R (x) 附加到原始数据后发送
  5. 接收端用同样的多项式进行校验，若余数为 0 则认为数据正确

CRC 算法的关键参数包括：

  • 宽度 (Width)：校验码的位数，常见的有 8 位、16 位、32 位等
  • 多项式 (Poly)：生成多项式，决定了校验的特性
  • 初始值 (Init)：CRC 计算的初始值
  • 异或输出 (XorOut)：计算完成后与结果异或的值
  • 输入反转 (RefIn)：是否对输入数据进行位反转
  • 输出反转 (RefOut)：是否对输出结果进行位反转

CRC 计算工具实现

下面介绍的 Qt 应用程序实现了一个功能完整的 CRC 计算工具，支持多种标准 CRC 算法和灵活的参数配置。

整体架构设计

该程序采用 Model-View 架构，主要包含以下几个部分：

  • 界面层：使用 Qt 的 UI 设计器创建交互界面
  • 模型层：定义 CRC 算法的参数模型
  • 控制层：处理用户输入和算法调用

.cpp核心代码解析

首先看一下 CRC 模型的定义，程序支持多种标准 CRC 算法：

#include "crcwidget.h"
#include <QVBoxLayout>
#include <QHBoxLayout>
#include <QLabel>
#include <QMessageBox>
#include <QRegularExpression>
#include "ui_crcwidget.h"
#include <QDebug>
#include<QString>
#include <QRegularExpression>

enum InputMode {//设置16进制和ASCII两种方式的输入
    HexMode,
    AsciiMode
};

struct CRCModel {
    QString name;         // 算法名称
    int width;            // 校验码宽度
    uint16_t poly;        // 生成多项式
    uint16_t init;        // 初始值
    uint16_t xorOut;      // 异或输出值
    bool refIn;           // 输入是否反转
    bool refOut;          // 输出是否反转
};

const QVector<CRCModel> presetModels = {// 预设的标准CRC模型
    {"CRC-16/CCITT",16, 0x1021, 0x0000, 0x0000, true, true},
    {"CRC-16/IBM", 16,0x8005, 0x0000, 0x0000, true, true},
    {"CRC-16/MODBUS", 16,0x8005, 0xFFFF, 0x0000, true, true},
    {"CRC-16/MAXIM", 16,0x8005, 0x0000, 0xFFFF, true, true},
    {"CRC-16/CCITT-FALSE", 16,0x1021, 0xFFFF, 0x0000, false, false},
    {"CRC-16/X25", 16,0x1021, 0xFFFF, 0xFFFF, true, true},
    {"CRC-16/XMODEM", 16,0x1021, 0x0000, 0x0000, false, false},
    {"CRC-16/DNP", 16,0x3D65, 0x0000, 0xFFFF, true, true},
    {"CRC-16/USB", 16,0x8005, 0xFFFF, 0xFFFF, true, true},
};

界面初始化和事件连接部分代码：

crcwidget::crcwidget(QWidget *parent)
    :QMainWindow(parent),
    ui(new Ui::crcwidget)
{
    ui->setupUi(this);
    setWindowTitle("CRC循环冗余校验");

    ui->polyLineEdit->setText("1021");
    ui->widthLineEdit->setText("16");
    ui->initLineEdit->setText("FFFF");
    ui->xorLineEdit->setText("0000");
    setupPresetModels();

    // 模式选择
    ui->modeComboBox->addItem("十六进制模式", HexMode);
    ui->modeComboBox->addItem("ASCII模式", AsciiMode);
    ui->modeComboBox->setCurrentIndex(0);

    connect(ui->crcTypeComboBox, QOverload<int>::of(&QComboBox::currentIndexChanged),
            this, &crcwidget::updateParams);
    connect(ui->calcButton, &QPushButton::clicked, this, &crcwidget::calculateCRC);
    connect(ui->clearButton, &QPushButton::clicked, this, &crcwidget::clearAll);
}

crcwidget::~crcwidget()
{
    delete ui;
}

CRC 计算的核心算法实现，这里使用了直接计算的方式：

uint16_t reverseBits16(uint16_t value) {
    uint16_t result = 0;
    for (int i = 0; i < 16; i++) {
        result = (result << 1) | (value & 1);
        value >>= 1;
    }
    return result;
}

uint32_t crcwidget::calculateCRC16(uint8_t *data, uint32_t len, uint16_t poly,int width,
                                   uint16_t init, uint16_t xorOut, bool refIn, bool refOut)
{

    qDebug()<<refIn<<refOut;
    qDebug()<<"="<<width;
    //qDebug()<<poly<<" "<<init<<" "<<xorOut;
   poly=  reverseBits16(poly);
    uint16_t crc = init;
    for(uint32_t i = 0; i <  len; ++i) {
        if(!refIn)
            data[i]=reverseByte(data[i]);
        crc ^= static_cast<uint16_t>(data[i]);
        for(int j = 0; j < 8; ++j) {
            if(crc & 0x0001) {
                crc = (crc >> 1) ^ poly;
            } else {
                crc >>= 1;
            }
        }
    }
   // crc=(crc ^ xorOut);
    qDebug()<<crc;
    if(!refOut) {
        crc = (reverseByte(crc >> 8) | reverseByte(crc & 0xFF)<< 8 );
        //crc= reverseByte(crc & 0xFFFF);
    }
    return crc ^ xorOut;
}

uint8_t crcwidget::reverseByte(uint8_t b)
{
    b = (b & 0xF0) >> 4 | (b & 0x0F) << 4;
    b = (b & 0xCC) >> 2 | (b & 0x33) << 2;
    b = (b & 0xAA) >> 1 | (b & 0x55) << 1;
    return b;
}

void crcwidget::clearAll()
{
    ui->inputTextEdit->clear();
    ui->resultHexLineEdit->clear();
    ui->resultBinLineEdit->clear();
}

输入处理与模式切换

程序支持两种输入模式：十六进制模式和 ASCII 模式，输入处理代码如下：

void crcwidget::setupPresetModels() {
    for(const auto &model : presetModels) {
        ui->crcTypeComboBox->addItem(model.name);
    }
    updateParams(0);  // 默认选择第一个模型
}

void crcwidget::updateParams(int index) {
    if(index >= 0 && index < presetModels.size()) {
        const CRCModel &model = presetModels[index];
        ui->polyLineEdit->setText(QString::number(model.poly, 16).toUpper());
        ui->widthLineEdit->setText(QString::number(model.width, 10).toUpper());
        ui->initLineEdit->setText(QString::number(model.init, 16).toUpper());
        ui->xorLineEdit->setText(QString::number(model.xorOut, 16).toUpper());
        ui->refInCheckBox->setChecked(model.refIn);
        ui->refOutCheckBox->setChecked(model.refOut);
    }
}

void crcwidget::updateMode(int index)
{
    Q_UNUSED(index);
    clearAll();

    InputMode mode = static_cast<InputMode>(ui->modeComboBox->currentData().toInt());
    if (mode == AsciiMode) {
        ui->inputTextEdit->setPlaceholderText("请输入ASCII字符串");
    } else {
        ui->inputTextEdit->setPlaceholderText("请输入16进制数据，如: 01 02 03 AB CD");
    }
}


void crcwidget::calculateCRC()
{
    QString input = ui->inputTextEdit->toPlainText();

    if(input.isEmpty()) {
        QMessageBox::warning(this, "错误", "请输入有效数据");
        return;
    }
    InputMode mode = static_cast<InputMode>(ui->modeComboBox->currentData().toInt());
    QByteArray data;
if (mode == HexMode) {//选择16进制运算
    // 格式化处理16进制
    QString formattedInput;
    QRegularExpression standardFormat("^(\\d{2}( \\d{2})*)?$");
    QRegularExpression hexFormat("^([0-9A-Fa-f]{2}( [0-9A-Fa-f]{2})*)?$");

    if(standardFormat.match(input).hasMatch() || hexFormat.match(input).hasMatch()) {
        formattedInput = input;
    } else {
        // 移除非数字和字母字符
        QString cleanInput = input;
        cleanInput.remove(QRegularExpression("[^0-9A-Fa-f]"));

        // 处理纯数字情况
        if(QRegularExpression("^\\d+$").match(cleanInput).hasMatch()) {
            // 确保每个数字都是两位数
            for(int i = 0; i < cleanInput.length(); i++) {
                if(!formattedInput.isEmpty()) formattedInput += " ";
                formattedInput += "0" + cleanInput.mid(i, 1);
            }
        } else {
            // 处理16进制混合情况
            if(cleanInput.length() % 2 != 0) {
                cleanInput.prepend('0');
            }
            for(int i = 0; i < cleanInput.length(); i += 2) {
                if(!formattedInput.isEmpty()) formattedInput += " ";
                formattedInput += cleanInput.mid(i, 2).toUpper();
            }
        }

        // 更新显示
        ui->inputTextEdit->setPlainText(formattedInput);
    }

    // 验证16进制输入
    QRegularExpression hexMatcher("^([0-9A-Fa-f]{2})( [0-9A-Fa-f]{2})*$");
    if(!hexMatcher.match(formattedInput).hasMatch()) {
        QMessageBox::warning(this, "错误", "请输入有效的16进制数据");
        return;
    }
    data = QByteArray::fromHex(formattedInput.remove(' ').toLatin1());
}
    else { //选择ASCII运算

    // 检查输入是否已经是格式化后的十六进制形式
    QRegularExpression hexFormat("^([0-9A-Fa-f]{2}( [0-9A-Fa-f]{2})*)?$");
    bool isHexFormatted = hexFormat.match(input).hasMatch();

    if (isHexFormatted) {
        // 如果已经是十六进制格式，直接转换为字节数组
        data = QByteArray::fromHex(input.remove(' ').toLatin1());
    } else {
        // 否则使用字符串的UTF-8编码
        data = input.toUtf8();

        // 显示格式化后的输入
        QString displayText;
        for (char c : data) {
            if (!displayText.isEmpty()) displayText += " ";
            displayText += QString("%1").arg(static_cast<uchar>(c), 2, 16, QLatin1Char('0')).toUpper();
        }
        ui->inputTextEdit->setPlainText(displayText);
    }
}
    // 获取CRC参数
    bool ok;
    uint16_t poly = ui->polyLineEdit->toPlainText().toUShort(&ok, 16);
    int width = ui->widthLineEdit->toPlainText().toUShort(&ok, 16);
    uint16_t init = ui->initLineEdit->toPlainText().toUShort(&ok, 16);
    uint16_t xorOut = ui->xorLineEdit->toPlainText().toUShort(&ok, 16);
    bool refIn = ui->refInCheckBox->isChecked();
    bool refOut = ui->refOutCheckBox->isChecked();

    // // 转换为字节数组
    // QByteArray data = QByteArray::fromHex(formattedInput.remove(' ').toLatin1());

    // 计算CRC
    uint16_t crc = calculateCRC16(reinterpret_cast<uint8_t*>(data.data()),
                                  data.size(),poly,width, init, xorOut, refIn, refOut);

    // 显示结果
    ui->resultHexLineEdit->setText(QString("%1").arg(crc, 4, 16, QLatin1Char('0')).toUpper());
    ui->resultBinLineEdit->setText(QString::number(crc, 2).rightJustified(16, '0'));
}

界面设计与用户交互

该 CRC 计算工具的界面设计遵循直观易用的原则，主要包含以下几个部分：

  1. 算法选择区：通过下拉框选择标准 CRC 算法，如 CRC-16/CCITT、CRC-16/MODBUS 等
  2. 参数配置区：显示和配置 CRC 算法的各项参数，包括多项式、初始值等
  3. 输入区：支持十六进制和 ASCII 两种模式的输入，并自动进行格式校验
  4. 结果显示区：以十六进制和二进制两种形式显示计算得到的 CRC 值
  5. 操作按钮：包括计算按钮和清除按钮，方便用户操作

功能拓展建议

在该现有程序的基础上面，还可以添加许多别的功能：

  1. 32 位 CRC 算法支持：如 CRC-32/ISO、CRC-32/MPEG-2 等
  2. 文件 CRC 计算：支持直接计算整个文件的 CRC 值
  3. 自定义多项式：允许用户输入任意多项式进行计算
  4. 历史记录功能：保存之前的计算结果，方便对比

不过博主个人比较懒，加上目前的工作对别的功能无太大需求，所以就没有写。

.h文件代码

此外，上述不过是该程序的所有.cpp代码，一下为该程序的.h部分代码：

#ifndef CRCWIDGET_H
#define CRCWIDGET_H

#include <QMainWindow>
#include <cstdint>

QT_BEGIN_NAMESPACE
namespace Ui {
class crcwidget;
}
QT_END_NAMESPACE

class crcwidget : public QMainWindow
{
    Q_OBJECT

public:
    explicit crcwidget(QWidget *parent = nullptr);
    ~crcwidget();

private slots:
    void calculateCRC();
    void clearAll();
    void updateParams(int index);  // 模型选择更新槽函数
    void updateMode(int index);    // 模式选择更新槽函数

private:
    uint32_t calculateCRC16(uint8_t *data, uint32_t len, uint16_t poly,int width,
                            uint16_t init, uint16_t xorOut, bool refIn, bool refOut);
    uint8_t reverseByte(uint8_t byte);

    void setupPresetModels();  // 预设模型初始化

    Ui::crcwidget *ui;
};

#endif // CRCWIDGET_H

运行结果

这就是该程序运行的UI界面这就是该文章的全部内容了，博主又要去愉快的工作（坚强）。

Codex 安装与 VS Code 联动：打造 AI 编程新体验
最新发布
weixin_44081096的博客
05-24 2361
本文详细介绍了如何将 OpenAI Codex 与 VS Code 编辑器深度集成，实现高效的 AI 编程辅助。从环境准备、API 接入到构建安全的本地代理服务，再到 VS Code 联动配置，提供了完整的实战指南。文章重点讲解了使用 Python FastAPI 搭建代理服务的完整流程，包括代码实现、错误处理和安全管理。同时涵盖了部署监控、性能优化以及云服务器部署方案，帮助开发者构建稳定、可扩展的生产级 AI 编程助手环境。
Codex 真香！终端 AI 编程神器装好了，Cursor可以不续费了
良逍Ai出海
09-06 1万+
Codex是OpenAI推出的智能编程助手，支持自然语言指令生成代码和终端操作，ChatGPT Plus用户可免费使用。它提供CLI终端模式和VSCode插件两种安装方式，支持GPT-5系列模型（暂不支持GPT-4o）。主要功能包括：直接执行终端任务、创建/修改代码文件、记忆任务历史等。安装后可能遇到404报错，通常由环境变量冲突导致，需检查并清理相关配置。Codex可与VSCode配合使用，完全替代Cursor编辑器，支持自定义AI助手规则。优势在于：免费、自然语言交互、丰富的终端功能，是提升开发效率的利
OpenAI最强编程助手Codex：下载安装、使用指南（含使用方式、提示技巧、趋势）
Code_流苏：在代码中寻诗意，在实践中觅真知
05-19 1万+
OpenAI最近上线了最强编程Agent——Codex，一起来看看吧！
VS Code + Codex 在 WSL 中使用的正确姿势
yangguangwuyue的博客
08-28 8219
Codex 登录只能在本地完成。文件仍可通过 UNC 路径访问 WSL → 本地 Codex 就能照常工作。避免在 WSL 内重复安装/登录 Codex 扩展。
Codex 完整指南（四）：多端使用全景图｜IDE、CLI、Cloud 与团队集成
阿甘兄
01-20 8357
本文系统梳理了 Codex 在 IDE、CLI、Web（Cloud）及 GitHub、Slack、Linear 等集成平台中的使用方式与适用场景。通过对不同端形态的对比，帮助读者理解如何在个人开发、自动化流程与团队协作中合理使用 Codex，将其真正落地为工程级编程智能体。
4千字总结：Codex 国内如何使用和安装的教程，以及如何设置中文回复
qq_41308489的博客
09-24 4万+
本文介绍了OpenAI最新编程工具Codex的安装与使用方法。Codex支持云端Web版和本地CLI版，最新GPT-5-Codex模型可处理7小时以上的复杂任务。文章详细讲解了两种安装方式：在VS Code等IDE上安装插件（推荐新手），以及通过npm或Homebrew安装CLI版本（支持macOS/Linux）。特别说明Windows用户需通过WSL安装，并提供了WSL安装教程。此外还介绍了Codex CLI的实用技巧，如设置中文回复、切换模型等注意事项。需要注意的是，目前Codex仅供ChatGPT P
OpenAI Codex深度解析：终端里的AI代码特工，一个指令重构整个项目
yunque_xianguang的博客
04-12 963
OpenAI Codex深度解析：终端里的AI代码特工 OpenAI Codex是一款革命性的AI编程工具，不同于传统的代码补全助手，它是一个能在本地终端运行的自主编程智能体。Codex CLI可以直接操作整个代码仓库，实现从代码生成到测试部署的全流程自动化。文章详细介绍了Codex与Copilot的本质区别、核心功能、安装配置方法以及三种权限模式（建议模式、自动编辑模式和完全自主模式）。特别强调了Codex能够完成复杂编程任务的能力，如模块实现、Bug修复、代码重构等，同时提供了针对国内用户的代理配置方案
Codex 全面实战教程：从安装到工程协作，一篇跑通
热门推荐
阿甘兄
01-27 6万+
这不是一篇泛泛而谈的 AI 编程介绍，而是一份完整跑通的 Codex 实战指南。从账号与环境准备，到 IDE / CLI / Cloud 的真实使用，再到用一句话完成工程任务，本文详细拆解 Codex 在真实开发流程中如何读仓库、改代码、跑命令，帮你把 AI 从“写代码的工具”，真正用成“工程协作者”。
VS Code集成Codex：高效编程全攻略
zhongxiaershi的博客
03-28 1559
本文详细介绍了将GPT Plus的Codex功能集成到VS Code终端的完整步骤。首先需要安装Python 3.7+、VS Code和OpenAI Python包，并获取API密钥。然后创建终端交互脚本，配置VS Code任务和快捷键绑定，实现直接在终端调用Codex生成代码的功能。文章还说明了API密钥的通用性，指出Codex权限需单独确认，并提供了权限验证方法。最后强调GPT Plus订阅不默认包含Codex服务，建议用户登录OpenAI平台检查具体权限。
VS Code + Codex 在 WSL 中的高效开发实践
blue的专栏
02-23 1487
本文针对在WSL环境中使用VS Code和OpenAI Codex时常见的登录失败问题，提供了根本性解决方案。通过深入分析VS Code远程扩展架构与WSL网络环境的冲突，指导开发者利用UNC路径（如\\wsl.localhost）在Windows本地安装并登录Codex，从而实现对WSL项目的高效AI辅助编程，并分享了集成终端、工作区配置等实战技巧以优化开发体验。
Vibe Coding - Codex最佳实践
小工匠
01-02 4511
本文对比了AI编程助手Codex、Claude Code和Cursor的差异，重点介绍了Codex的安装配置与高阶用法。Codex以CLI为核心，支持MCP协议，提供高度定制化能力，适合技术深度使用者；而Claude Code和Cursor更偏向开箱即用的集成方案。文章详细讲解了Codex的全局配置（config.toml、环境变量）、插件调优技巧，以及通过AGENTS.md实现角色化协作的方法，强调其系统性思维和工具链整合优势。相比其他工具，Codex在调试透明度、多工具协作和长期稳定性方面表
VS Code + Codex 在 WSL 中登录失败的终极解决方案（附详细步骤）
weixin_28829629的博客
03-30 840
本文提供了在WSL环境中解决VS Code与Codex登录失败的终极方案，详细介绍了通过UNC路径访问WSL项目的步骤，帮助开发者充分利用Codex的代码补全功能。文章涵盖环境配置、扩展安装、登录流程及性能优化等关键内容，特别适合遇到403错误或回调问题的开发者参考。
VS Code Codex 登录失败（1455 端口占用）处理说明
wdfk-prog.space
02-10 6562
该错误属于本地端口冲突占用者通常是异常残留的 VS Code / 扩展进程定位进程 → 结束进程 → 完全重启 VS Code处理完成后即可恢复正常登录流程该问题在 Windows 环境下较为常见，属于已知行为，并非配置或使用错误。
Codex 安装与 VS Code 联动：手把手配置指南
油墨香^-^的博客
05-20 1505
本指南系统地介绍了 OpenAI Codex 与 VS Code 集成的四种核心方案。从最简单的官方插件一键安装，到终端代理 CLI 的深度使用，再到完全本地化的隐私优先方案和面向企业级定制的 API 开发——无论你处于哪个阶段，都能找到最适合自己的配置路径。
史上最全！一文带你拿下市面主流AI编程，最新Claude/Codex/Kimi...安装教材，彻底搞懂插件版和命令行版！（上）
weixin_64304261的博客
05-17 1万+
这两个文件是CC-Switch的配置文件，在编辑供应商的下面可以找到，它与你本机C:\Users\Administrator\.codex这个路径下的文件会保持一致，这也是api配置的核心文件，如果你的环境或者api出了问题，这两个配置文件一定是优先检查的！用户最容易遇到的几个问题。
AI编程终端三剑客实战指南：Claude Code、Codex CLI、Gemini CLI 场景化选型与避坑
pytorch8learner的博客
03-07 756
本文针对AI编程终端工具Claude Code、Codex CLI和Gemini CLI，提供基于真实开发场景的实战选型指南。文章深入分析了在遗留系统重构、快速原型开发、紧急Bug修复和技术学习四大核心场景下，如何根据工具特性（如深度理解、持久执行、免费大容量）进行精准选择，并分享了关键避坑策略，帮助开发者将AI编程工具高效转化为生产力。
代码生成的原理解析：从Codex、GitHub Copliot到CodeLlama(用了NTK-aware)、CodeGeex
结构之法 算法之道
12-04 1万+
我们在这篇文章《》中的2.5节有提到，“2021 年7月，OpenAI发布Codex的论文《》，其中初始的Codex是根据120亿参数的GPT-3变体进行微调的，且通过对159GB的Python代码进行代码训练，后来这个120 亿参数的模型演变成OpenAI API中的code-cushman-001，具备较强的代码/推理能力”接下来，我们来看下Codex背后的原理到底是怎样的，即其是如何一步一步训练出来的。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值