PHP生成二维码中文乱码的根本原因是GD库未指定中文字体导致UTF-8被错误解析，解决需用endroid/qr-code v4+配真实TTF字体（如simhei.ttf），或对旧库强制GBK转码，或改用URL编码传递中文参数。
PHP生成二维码时中文乱码的根本原因
不是二维码库本身不支持中文，而是默认用 UTF-8 编码生成的字符串，被某些二维码读取器（尤其是旧版微信、部分安卓扫码工具）误判为 GBK 或 ISO-8859-1。更关键的是：很多 PHP 二维码库（比如 endroid/qr-code 3.x 或原生 phpqrcode）在底层调用 GD 绘图时，若未显式指定字体路径或编码处理，imagefttext() 会直接把 UTF-8 字节流当单字节处理，导致每个中文字符被拆成 2–3 个乱码符号。
用 endroid/qr-code v4+ 正确显示中文（推荐）
v4 开始强制要求传入 string 类型内容，且内部已做 UTF-8 安全封装，但必须配合真实中文字体文件使用，否则仍会 fallback 到系统默认无中文支持的字体。
- 安装：
composer require endroid/qr-code:^4.0 - 准备一个含中文的 TTF 文件（如
simhei.ttf），放在项目目录下（例如./fonts/simhei.ttf） - 生成代码必须显式设置字体：
use Endroid\QrCode\QrCode;
use Endroid\QrCode\Writer\PngWriter;
$qrCode = QrCode::create('你好，世界！')
->setSize(300)
->setEncoding('UTF-8'); // 这行可选，v4 默认就是 UTF-8
$writer = new PngWriter();
$result = $writer->write($qrCode, null, [
'font_path' => './fonts/simhei.ttf', // ⚠️ 必须设！否则中文变方块或乱码
]);
header('Content-Type: image/png');
echo $result->getString();
注意：font_path 必须是服务器上真实可读的绝对或相对路径，不能是 URL；字体文件需有执行用户读取权限。
用老旧 phpqrcode 库临时救急（不推荐长期用）
该库已多年未维护，中文支持靠手动转码 + 指定字体，容易出错。仅适用于无法升级依赖的遗留系统。
立即学习“PHP免费学习笔记（深入）”；
公众号运营：文章发布至草稿、样式封面、评论与用户管理、数据统计等。用户要求将 Markdown 发送到公众号草稿、查看阅读量统计或类似后台操作时，使用本技能。
- 下载带中文字体的修改版
phpqrcode.php（原版不带字体支持） - 调用前必须用
iconv()强制转为 GBK（部分扫码器只认这个）：
$content = iconv('UTF-8', 'GBK//IGNORE', '你好，世界！');
QRcode::png($content, false, QR_ECLEVEL_L, 4, 2, false, 0x000000, 0xFFFFFF, './fonts/simhei.ttf');
参数说明：0x000000 是文字颜色，0xFFFFFF 是背景色，最后一个参数才是字体路径；GBK//IGNORE 表示丢弃无法转换的字符，避免因个别生僻字中断生成。
绕过字体依赖：用 Base64 嵌入文字信息（纯数据方案）
如果只是需要「扫码后跳转并携带中文参数」，而非二维码图案里显示中文，就根本不需要字体。把中文内容 URL 编码后拼进链接即可：
$url = 'https://example.com?name=' . urlencode('张三') . '&city=' . urlencode('上海');
$qrCode = QrCode::create($url)->setSize(300);
这样生成的二维码内容是标准 ASCII 字符串，100% 兼容所有扫码器，且服务端接收到的仍是正确 UTF-8 参数。真正需要图案内显示中文的场景其实极少，多数是误解需求。
字体路径权限、字符集转换时机、扫码终端的编码猜测逻辑——这三处任一出错都会表现为乱码，调试时优先查日志里是否报 Could not find font 或 iconv(): Detected an illegal character。
