用JavaScript生成二维码的库不少，哪种最轻量好用

给页面加一个二维码，听起来是很小的需求，真到选库时却容易被 npm 搜索结果带偏：有的包功能齐全但体积惊人，有的轻到只有算法却要自己画图，还有的停更多年却依然排在前列。到底哪种最轻量好用，不能只看“压缩后多少 KB”，还要看依赖、输出方式、维护状态和你的使用场景。

先定义“轻量”和“好用”

轻量不只是 min+gzip 体积小。零依赖、支持 tree-shaking、按需引入、只生成二维码矩阵而不强行绑定 UI，都算轻量。好用则包括：API 直观、支持 canvas/SVG/dataURL、能在浏览器和 Node 跑、有 TypeScript 类型、文档别太劝退。一个库如果只有 3KB，但需要你手动处理纠错、编码和绘制，那对普通项目来说未必“好用”。

常见选手速览

`qrcodejs` 是很多人最早接触的库，`new QRCode(element, options)` 就能用，体积也不大。但它的硬伤是停更多年、全局变量风格、对现代构建不友好，新项目不太建议优先选。

`qrcode-generator` 是经典算法库，零依赖，体积极小，支持多种输出。它的 API 偏底层，需要自己调用 `addData`、`make`，但稳定、兼容性好，适合老项目或想自己控制渲染的场景。

`node-qrcode` 功能非常全，浏览器和 Node 都能用，支持 `toCanvas`、`toDataURL`、`toString` 等。缺点是包体积和依赖都不算小，如果你只是前端画一个二维码，会有点“杀鸡用牛刀”。

`qrcode.react` 是 React 项目里的顺手选择，直接 `<QRCodeSVG value="..." />`。但它依赖 React，不适合通用场景，也不能算最轻量。

`qr-code-styling` 适合做 logo、渐变、圆点、自定义图案的“艺术二维码”，效果很好，但体积也明显更大。它解决的是好看问题，不是轻量问题。

如果只选一个，我推荐 uqr

`uqr` 是 UnJS 生态里的库，零依赖、ESM 友好，体积只有几 KB 级别，能生成 SVG、ANSI、Unicode 等输出。对现代前端和 Node 项目来说，它是我目前最愿意默认选择的二维码库：

import { renderSVG } from 'uqr'

const svg = renderSVG('https://example.com')
document.querySelector('#qr').innerHTML = svg

它的思路很干净：核心负责编码和矩阵，渲染层保持简单。你不需要引入一整套 UI 逻辑，就能拿到清晰的 SVG。如果要在终端里显示二维码，它也能直接输出 ANSI/Unicode，这一点很实用。

当然，`uqr` 不是万能。它没有内置 logo、渐变、圆点样式，想做营销风格二维码，还是得换 `qr-code-styling` 或自己二次渲染。

具体怎么选

如果你是现代前端或 Node 项目，追求轻量、零依赖、SVG 清晰，优先选 `uqr`。如果你维护老项目，需要全局 script 或经典稳定，选 `qrcode-generator`。React 项目直接用 `qrcode.react` 最省事。服务端批量生成、需要多种格式输出，`node-qrcode` 更全面。需要 logo、渐变、自定义样式，就接受 `qr-code-styling` 的体积。

总结

二维码库没有绝对冠军，但“最轻量好用”这个需求下，`uqr` 目前最均衡：小、快、零依赖、现代 API，适合大多数基础生成场景。`qrcode-generator` 是经典备选，`node-qrcode` 和 `qrcode.react` 适合更具体的生态，`qr-code-styling` 则留给需要重样式的人。选库前先问自己：我只要一个能扫的二维码，还是要一个能当海报元素的二维码？答案不同，选择就不同。