节流函数不适用于扫码枪高频输入，因其会丢弃中间字符导致条码不完整；应采用防抖+输入缓冲+回车判定方案，监听keydown事件、过滤非打印字符、遇Enter拼接并清空缓存，配合120ms防抖兜底。
节流函数不适合扫码枪高频连续输入的场景，它会丢弃中间的输入，导致指令不完整。扫码枪本质是模拟键盘快速输入，通常以“回车”结尾，正确做法是用防抖（debounce）+ 输入缓冲，而非节流（throttle）。
为什么节流不适用扫码枪？
节流是在固定时间间隔内最多执行一次，比如 300ms 内只取第一次或最后一次事件。但扫码枪输入是一串字符（如 "123456789"）加一个回车符（Enter），整个过程可能在 20~50ms 内完成。节流会截断中间字符，只剩开头或结尾，无法拼出完整条码。
推荐方案：防抖 + 输入监听 + 回车判定
核心思路是监听 input 或 keydown，收集所有按键，等用户“停顿”（即扫码动作结束）后再处理。扫码枪触发快、停顿明显，防抖天然匹配这一节奏。
Java Maven Common
下载
Java Maven 项目审查工作流的通用输入处理。当 Java Maven 项目以 ZIP压缩包或 GitLab 仓库 URL 形式提供且需要...时使用。
- 监听
document.addEventListener('keydown', handler)，捕获所有键码 - 过滤掉非打印字符（如 Ctrl、Shift），保留数字、字母、回车（keyCode 13 或 key === 'Enter'）
- 遇到回车时，把之前缓存的字符拼成完整指令，清空缓存
- 设置 100~150ms 防抖：若连续输入未中断，不急于提交；一旦停顿超时，自动提交（兜底，防扫码枪无回车异常）
简易可运行示例
以下代码可直接嵌入页面，支持多数 USB 扫码枪（默认输出带回车）：
立即学习“Java免费学习笔记（深入）”；
let scanBuffer = '';
let debounceTimer = null;
function handleScan(inputChar) {
if (inputChar === 'Enter') {
if (scanBuffer.trim()) {
console.log('扫码完成：', scanBuffer.trim());
// ✅ 在这里处理完整指令，如提交表单、查询商品
onScanComplete(scanBuffer.trim());
}
scanBuffer = '';
} else {
scanBuffer += inputChar;
}
}
document.addEventListener('keydown', (e) => {
// 优先使用 e.key（更现代），兼容旧浏览器可用 e.keyCode
const key = e.key || String.fromCharCode(e.keyCode);
// 忽略功能键、修饰键
if (e.ctrlKey || e.altKey || e.metaKey || e.shiftKey) return;
// 只处理可打印字符和回车
if (/^[^\x00-\x1F\x7F-\x9F\u2000-\u206F\u20A0-\u20CF\u2100-\u214F\u2E00-\u2E7F\u3000-\u303F\u3040-\u309F\u30A0-\u30FF\u3400-\u4DBF\u4E00-\u9FFF\uF900-\uFAFF]+$/.test(key) || key === 'Enter') {
handleScan(key);
// 防抖重置：每次有输入就延后提交判断
clearTimeout(debounceTimer);
debounceTimer = setTimeout(() => {
if (scanBuffer.trim()) {
console.warn('扫码超时提交（无回车）：', scanBuffer.trim());
onScanComplete(scanBuffer.trim());
scanBuffer = '';
}
}, 120);
}
});
function onScanComplete(code) {
// 替换为你的业务逻辑，例如：
// document.getElementById('barcode-input').value = code;
// fetch('/api/lookup?code=' + encodeURIComponent(code));
}
进阶注意点
-
扫码枪配置：部分设备可设置“后缀字符”，确认是否真以 Enter 结尾；也可设为 Tab 或自定义符号，对应修改
handleScan中的判定条件 -
焦点问题：扫码枪默认向当前聚焦元素输入。如需全局捕获，确保监听在
document级别，并防止输入框意外抢焦（可禁用 input/textarea 的默认行为，但需谨慎） -
重复扫码：同一码短时间内扫多次？可在
onScanComplete中加时间去重或队列限流 -
移动端兼容：手机扫码 App 通常走 input 事件而非 keydown，建议同时监听
input并结合setTimeout做短延迟合并
