用 Rust 打造二维码艺术大师：从想法到实现

Ne0inhk

28 Feb 2026 — 5 min read

二维码已经渗透到我们生活的方方面面，从支付到网站链接，几乎无处不在。但你有没有想过，二维码是怎么生成的？这些黑白方块也可以变得有趣和美观？今天我就来分享一下我用 Rust 实现的一个小项目：二维码艺术生成器（qr-artist）。

项目起源

这个想法源于一个简单的需求：如何让二维码既实用又美观？普通的黑白二维码虽然功能强大，但看起来有些单调。我想，能不能让二维码变得更有艺术感，比如用彩色像素来呈现？

技术选型

我选择了 Rust 作为开发语言，因为它在系统编程方面的优秀表现和内存安全特性。项目中主要使用了以下几个库：

qrcode - 用于生成二维码数据
image - 用于图像处理和保存
clap - 用于构建命令行界面

这些库都很成熟且文档完善，让我能够专注于核心功能的实现。

核心实现

1. 基础二维码生成

项目的核心是将 URL 转换为二维码数据，然后将其渲染为图像：

// 创建二维码let code =QrCode::new(args.url.as_bytes())?;// 获取二维码数据let modules = code.to_colors();

2. 自定义像素样式

为了让二维码更有趣，我实现了几种不同的像素样式：

方形（square） - 默认样式，传统的方块
圆形（circle） - 圆润的点状样式
圆角矩形（rounded） - 方形但带有圆角

这部分的实现主要通过在每个像素位置绘制不同的形状来完成：

match style {"circle"=>{draw_circle_mut(img, px, py, pixel_size, color);}"rounded"=>{draw_rounded_square_mut(img, px, py, pixel_size, color);} _ =>{// 默认方形for dy in0..pixel_size {for dx in0..pixel_size {let pixel_x = px + dx;let pixel_y = py + dy; img.put_pixel(pixel_x, pixel_y, color);}}}}

3. 彩色支持

为了让二维码更加个性化，我添加了彩色支持。用户可以通过命令行参数指定不同的颜色方案来表示深色和浅色区域。

对于未预定义的颜色，我们还实现了一个智能颜色生成算法，确保任何输入都能产生有效的颜色：

// Simple hash function to generate consistent colorsletmut hash:u32=0;for byte in input.bytes(){ hash = hash.wrapping_mul(31).wrapping_add(byte asu32);}// Generate RGB values from hashlet r =(hash &0xFF)asu8;let g =((hash >>8)&0xFF)asu8;let b =((hash >>16)&0xFF)asu8;

4. 彩虹效果

为了让二维码更加炫酷，我还添加了彩虹效果，通过算法将不同位置的深色模块渲染成不同的彩虹颜色：

fnget_rainbow_color(x:u32, y:u32, size:u32)->Rgba<u8>{let pos =((x + y)asf32/(size *2)asf32)*255.0;let hue = pos asu8;// HSV 到 RGB 的转换// ...}

使用示例

项目完成后，你可以通过以下命令生成不同风格的二维码。

生成基础黑白二维码

cargo run -- --url "https://github.com" --output github.png

生成圆形像素风格

cargo run -- --url "https://github.com" --style circle --output circle_qr.png

生成彩虹效果二维码

cargo run -- --url "https://github.com" --rainbow --output rainbow_qr.png

结合多种效果

cargo run -- --url "https://github.com" --style circle --rainbow --output rainbow_circle_qr.png

艺术化设计原则

在创建艺术化二维码时，我们需要平衡美观性和功能性：

对比度：确保深色和浅色模块之间有足够的对比度，以保证可扫描性
清晰度：避免使用过于复杂或模糊的图案
尺寸：适当增大像素尺寸可以让细节更清晰
颜色：选择对比明显的颜色组合

总结

这个项目虽然看起来简单，但涵盖了从需求分析、技术选型、实现细节到问题解决的完整开发流程。通过这个项目，我不仅加深了对 Rust 语言的理解，也学到了二维码的内部结构和图像处理的基础知识。

更重要的是，这个项目让我意识到，即使是像二维码这样常见的技术，我们也可以通过创意和编程技巧，让它变得更加有趣和个性化。如果你对这个项目感兴趣，不妨试试自己动手实现一个，或者在现有基础上添加更多有趣的功能！

想了解更多关于Rust语言的知识及应用，可前往华为开放原子旋武开源社区（https://xuanwu.openatom.cn/），了解更多资讯～