qrcode.toFile() 报 ENOENT 是因父目录不存在，需用 fs.mkdirSync(..., {recursive:true}) 预创建；异步未等待导致无输出，须 await 或正确传回调；URL 含中文等需 encodeURIComponent 编码；加 logo 需 jimp 等库二次合成，并调高 errorCorrectionLevel。
npm install qrcode 之后为什么 qrcode.toFile() 报错 ENOENT？
常见原因是输出路径的父目录不存在，qrcode.toFile() 不会自动创建多级目录。比如写 qrcode.toFile('dist/qrcode.png', 'https://example.com')，但 dist 文件夹根本没建，就会直接抛 ENOENT: no such file or directory。
解决办法很简单：提前创建目录，或换用支持自动建目录的封装方式：
- 用 Node.js 原生
fs.mkdirSync(path.dirname(filePath), { recursive: true })预创建父目录 - 或者改用
qrcode.toString()先生成 base64 或 SVG 字符串，再手动写文件（更可控） - 注意：Windows 路径分隔符建议统一用
/或path.join()，避免硬写\导致路径拼接失败
VSCode 终端里跑 node generate-qrcode.js 没反应，怎么调试？
多数情况是脚本执行完就退出，没等异步操作完成。比如直接写 qrcode.toFile(...) 但没处理 Promise 或回调，Node.js 主线程不等待就结束了。
必须确保异步操作被正确 await 或 callback 处理：
- 如果用
async/await，整个脚本需包裹在(async () => { ... })()中，且toFile()返回 Promise，要await - 如果用回调形式，必须传入
(err) => { if (err) throw err; console.log('done'); }，否则错误静默吞掉 - 加一句
console.log('QR code saved')放在成功回调里，比看文件是否存在更早确认逻辑走通
生成的二维码扫出来是乱码或打不开网页？
本质是输入内容编码问题。URL 中含中文、空格、特殊符号时，未 encodeURIComponent() 就直接传给 qrcode，会导致扫码后跳转地址出错。
Comprehensive Three.js 3D graphics reference
下载
详细的 Three.js 3D 图形参考，涵盖场景设置、相机、几何体、材质、光照、动画、控制器、加载器、数学工具和调试。
安全做法始终对原始字符串做 URI 编码：
- 如果是 URL，用
encodeURIComponent(url)再传入qrcode.toFile() - 如果是纯文本（如联系人信息），也要考虑是否含换行符——
qrcode默认把换行转成%0A，但某些扫码器不识别，可先用text.replace(/\n/g, '\r\n')统一换行符 - 避免直接拼接变量进字符串：不要写
`https://site.com?id=${id}`，而应`https://site.com?id=${encodeURIComponent(id)}`
想让二维码带 logo 怎么办？
qrcode 库本身不支持嵌入 logo，它只生成标准二维码矩阵。真要加 logo，得用图像处理库二次合成，比如 canvas 或 jimp。
推荐轻量方案：jimp + qrcode 组合：
- 先用
qrcode.toBuffer()得到 PNG Buffer - 用
new Jimp(buffer)加载，再composite(logoBuffer, x, y)叠加 logo 图片 - 最后
jimpImage.write('output.png')保存——注意 logo 图片尺寸别超过二维码边长 1/4，否则影响识别率 - 别用
qrcode.toFile()和jimp混用，容易因异步时机错乱导致写空图
真正难的不是加 logo，而是控制容错率和尺寸平衡。默认 errorCorrectionLevel: 'M' 是安全起点，改成 'H' 才能撑住小 logo，但生成速度略慢。
