Rust QRCode 性能比较#

测试环境#

• 平台: Windows
• Rust: rustc 1.89.0
• 测试时间: 2026-02-02

比较的包#

• qrcode-rust - 功能完整的 Rust QRCode 实现
• qrcode-fast - 极致性能优化版本
• kennytm-qrcode - 流行的 Rust QRCode 库（作为基准）

📊 性能可视化#

性能对比#

不同纠错级别性能#

🚀 性能提升#

📋 功能对比#

性能测试结果#

三者对比#

基于 criterion 基准测试框架的最新结果（2026-02-02）：

*注：kennytm-qrcode 的 SVG 生成使用了不同的渲染方式，直接输出字符而不是 SVG XML，所以看起来更快，但功能不同

文本长度对比#

验证结果#

使用 rust-tools 验证工具对生成的 SVG 进行验证：

# 生成并验证二维码
cargo run --release --features validation --bin validate-qr -- "Hello World"

# 输出：
# 🚀 QRCode 生成 + 验证工具
# ═══════════════════════════════════════
# 文本: Hello World
# 
# ✅ 验证通过！
#    二维码可以被正确扫描
#    内容匹配: 'Hello World'

验证结论:

• qrcode-rust 生成的二维码 SVG 可以通过标准二维码扫描器正确解码，内容匹配
• qrcode-fast 生成的二维码也可正确解码

与 kennytm-qrcode 的兼容性#

经过详细调试和修复，qrcode-rust 和 qrcode-fast 现在与 kennytm-qrcode 在以下方面保持一致：

关键修复 (2026-02-02)#

1. 格式信息放置修复

   • 垂直方向（第8列）：从上到下正确放置
   • 水平方向（第8行）：从右到左正确放置
   • 正确处理 test 模式（格式信息位在 test 模式下为白色）

2. Mask Pattern 修复

   • 统一使用 mask pattern 0: (row + col) % 2 == 0
   • 确保与 kennytm 的默认选择一致

使用建议#

运行基准测试#

# 运行 Rust 基准测试（包含三者对比）
cd packages/qrcode-rust
cargo bench --bench comparison_bench

# 查看详细报告
target/criterion/report/index.html

# 使用 rust-tools 验证生成的 SVG
cd bench/rust-tools
cargo run --release --features validation --bin validate-qr -- "你的文本"

详细报告位置#

基准测试的详细报告生成在：

• target/criterion/ - Criterion 基准测试报告

可以使用浏览器打开查看图表和详细分析：

# 在 Windows 上
start target/criterion/report/index.html

技术细节#

测试方法#

使用 Criterion.rs 进行基准测试：

• 预热时间: 3 秒
• 采样次数: 100 次
• 测量时间: 约 5 秒/测试

测试数据#

• 短文本: "https://a.co" (12 字符)
• 中等文本: "https://github.com/veaba/qrcodes" (36 字符)
• 长文本: 包含多个参数的 URL (98 字符)

SVG 验证工具#

位于 bench/rust-tools，提供以下功能：

• validate-qr - 生成并验证二维码
• compare_matrix - 对比模块矩阵与 kennytm
• compare_matrix_v1 - 对比版本 1 的矩阵

数据文件: backend_benchmark_pk.json | backend_benchmark_pk_summary.json

测试代码: packages/qrcode-rust/benches/comparison_bench.rs

最后更新: 2026-02-02 (添加 qrcode-fast 对比，格式信息修复完成)