3分钟搞懂手写汉字识别,前端转岗必看的实战细节
官方文档翻了三遍还是头大？别慌，我当年转行做前端时，被手写实现汉字识别这个需求卡得死死的。那时候我就想，为什么非要搞这么复杂？其实核心逻辑没那么玄乎。
今天就把压箱底的经验掏出来。不聊那些虚的理论，直接上代码，带你从零搭建一个能跑通的手写汉字识别 Demo。不管你是刚入行的小白，还是想拓展技能树的前端老哥，这篇能帮你把手写汉字这块硬骨头啃下来。
概念速懂：别被术语吓跑
很多人一听“手写汉字识别”，脑子里全是深度学习、CNN、RNN这些高大上的词。先冷静，我们从最基础的视角看。
在前端开发场景里，我们通常不直接训练模型（那是后端或算法工程师的事），我们要做的是数据采集和前端预处理。简单说，就是用户在屏幕或触控板上写一个字，你要把这一笔一划变成计算机能懂的数据格式，然后发给后端去识别，或者调用 API 返回结果。
这里有个关键概念：笔画轨迹。
计算机不认识“字”，它只认识“点”。当用户手指划过屏幕，我们要记录下的不是“这是一个横”，而是 (x1, y1, t1), (x2, y2, t2) 这样的坐标和时间戳序列。
为什么时间戳 t 重要？因为手写有时序性。写“人”字，先撇后捺；写“大”字，先横后撇再捺。如果只给一堆散点，计算机分不清这是“人”还是“入”，甚至可能是乱码。所以，手写实现的核心，就是高精度地捕捉并清洗这些带时间戳的坐标数据。
在掘金技术社区上看到不少前端大佬分享过类似项目，大家普遍遇到的第一个坑就是：采样频率太低，线条断断续续；或者频率太高，数据量爆炸，传输卡顿。怎么平衡？这就是下面我们要解决的环境准备问题。
环境准备：别用错工具
既然面向前端转岗，咱们就用最熟悉的技术栈：HTML5 Canvas + 原生 JavaScript。
为什么不用 Vue 或 React？因为底层交互逻辑是一样的，框架只会增加理解成本。等你用原生跑通了，迁移到框架里也就是封装个组件的事。
你需要准备的环境很简单：一个支持 HTML5 Canvas 的浏览器（Chrome、Firefox 均可）。
一个本地服务器（如 VS Code 的 Live Server 插件），因为直接双击打开 HTML 文件，某些 API 可能会受限。
如果要在手机上测试，确保你的开发设备支持触摸事件（Touch Events）。这里有个小细节：Canvas 的默认坐标系原点在左上角，x 轴向右，y 轴向下。这点和数学坐标系（y 轴向上）是反的，新手写变换逻辑时容易在这里栽跟头，心里有个数就行。
另外，关于手写汉字的字体渲染，我们不需要加载字体文件。因为我们要记录的是用户的“笔迹”，而不是“打印字”。用户写的是草书还是楷书，那是算法模型要适配的，前端只负责如实记录。
核心语法：抓住这三个 API
要手写实现轨迹捕捉，重点就三个 API：getContext('2d')、requestAnimationFrame、addEventListener。
别被名字唬住，我拆开讲：canvas.getContext('2d')
这是获取绘图上下文的钥匙。没有它，Canvas 就是个空盒子。我们需要用到它的 beginPath()、moveTo()、lineTo() 和 stroke() 方法来绘制线条。但注意，我们的目的不是“画出来给用户看”，而是“记录下来给算法用”。绘图只是为了视觉反馈，让用户知道“我写上了”。addEventListener (触摸/鼠标事件)
这是数据入口。桌面端：监听 mousedown（按下）、mousemove（移动）、mouseup（抬起）。
移动端：监听 touchstart、touchmove、touchend。
坑点：mousemove 和 touchmove 的触发频率非常高，有时候一秒钟能触发几十次甚至上百次。如果你每次触发都存数据，数组会瞬间膨胀。requestAnimationFrame
这是性能优化的神器。它不是用来监听事件的，而是用来控制绘制频率的。但在这里，我们可以借它的思路来理解“帧”的概念。真正的优化策略是：在事件监听器里，不要立刻保存所有坐标，而是先暂存，或者进行抽稀（Thinning）。什么是抽稀？就是去掉那些“差不多”的点。比如，如果两个相邻点的距离小于 2 像素，且时间间隔小于 5 毫秒，第二个点就可以丢弃。这样既保证了线条平滑，又控制了数据量。
还有一个关键点：笔画切分。用户写“王”字，中间可能停顿一下。如果停顿时间超过 300 毫秒，前端应该判定为“新笔画开始”，在数据结构里开一个新数组。否则，算法会把停顿后的笔迹当成同一笔画的抖动，识别率直接崩盘。
完整代码示例：跑起来才叫懂
光说不练假把式。下面这段代码，你可以直接复制到 HTML 里运行。它实现了基本的笔画捕捉、实时绘图和数据结构存储。
!DOCTYPE html
html lang=zh-CN
headmeta charset=UTF-8meta name=viewport content=width=device-width, initial-scale=1.0title手写汉字轨迹捕捉 Demo/titlestylebody {display: flex;flex-direction: column;align-items: center;justify-content: center;height: 100vh;margin: 0;background-color: #f0f0f0;font-family: sans-serif;}#canvas-container {position: relative;}canvas {background-color: white;border: 2px solid #333;cursor: crosshair;/* 防止移动端触摸时的默认滚动行为 */touch-action: none; }#btn-clear {margin-top: 20px;padding: 10px 20px;font-size: 16px;cursor: pointer;}#data-log {margin-top: 20px;width: 80%;height: 150px;overflow-y: auto;background: #222;color: #0f0;padding: 10px;font-family: monospace;font-size: 12px;border-radius: 4px;}/style
/head
bodydiv id=canvas-container!-- 设置画布大小，注意 CSS 大小和 Canvas 内部像素要一致，否则模糊 --canvas id=writeCanvas width=300 height=300/canvas
/divbutton id=btn-clear清除画布/button
div id=data-log点击“清除”后开始书写，数据将显示在此.../divscriptconst canvas = document.getElementById('writeCanvas');const ctx = canvas.getContext('2d');const dataLog = document.getElementById('data-log');const btnClear = document.getElementById('btn-clear');// 核心数据结构：存储所有笔画// 结构: [ [ {x, y, t}, {x, y, t}, ... ], [ ... ] ]let allStrokes = []; let currentStroke = [];let isDrawing = false;let lastTimestamp = 0;let lastPoint = { x: 0, y: 0 };// 配置参数const MIN_DISTANCE = 3; // 最小记录距离(像素)，用于抽稀const STROKE_BREAK_TIME = 300; // 笔画断开的时间阈值(毫秒)/*** 获取事件坐标，兼容鼠标和触摸*/function getCoords(e) {const rect = canvas.getBoundingClientRect();let clientX, clientY;if (e.touches e.touches.length 0) {clientX = e.touches[0].clientX;clientY = e.touches[0].clientY;} else {clientX = e.clientX;clientY = e.clientY;}// 减去画布在页面中的偏移，得到相对于画布的坐标return {x: clientX - rect.left,y: clientY - rect.top};}/*** 判断是否需要记录新点（抽稀算法）*/function shouldRecordPoint(newPoint) {const distance = Math.sqrt(Math.pow(newPoint.x - lastPoint.x, 2) + Math.pow(newPoint.y - lastPoint.y, 2));// 如果距离足够远，或者距离近但时间间隔较长（防止抖动），则记录return distance MIN_DISTANCE;}/*** 开始绘制/捕捉*/function startDrawing(e) {e.preventDefault(); // 阻止默认行为，如页面滚动isDrawing = true;// 如果距离上次结束时间很短，可能是误触或连续笔画，这里简单处理：新开一个笔画// 实际项目中可根据 lastTimestamp 判断是否延续上一笔画currentStroke = [];const coords = getCoords(e);const now = Date.now();// 初始化最后一点lastPoint = coords;lastTimestamp = now;// 记录第一个点currentStroke.push({ x: coords.x, y: coords.y, t: now });// 绘制起点ctx.beginPath();ctx.moveTo(coords.x, coords.y);}/*** 移动/捕捉中间点*/function moveDrawing(e) {if (!isDrawing) return;e.preventDefault();const coords = getCoords(e);const now = Date.now();// 检查是否发生笔画断开（停顿过长）if (now - lastTimestamp STROKE_BREAK_TIME) {// 结束当前笔画，存入总集合if (currentStroke.length 1) {allStrokes.push(currentStroke);updateLog();}currentStroke = [];ctx.beginPath(); // 断开线条}// 抽稀判断if (shouldRecordPoint(coords)) {currentStroke.push({ x: coords.x, y: coords.y, t: now });// 实时绘制，给用户视觉反馈ctx.lineTo(coords.x, coords.y);ctx.strokeStyle = 'black';ctx.lineWidth = 4;ctx.lineCap = 'round';ctx.stroke();// 更新参考点lastPoint = coords;lastTimestamp = now;}}/*** 结束绘制/捕捉*/function endDrawing(e) {if (!isDrawing) return;isDrawing = false;// 将最后一笔存入总集合if (currentStroke.length 1) {allStrokes.push(currentStroke);updateLog();}currentStroke = [];}/*** 更新日志显示，模拟发送给后端的数据*/function updateLog() {// 这里只打印最后一条笔画的前5个点，避免日志过长const lastStroke = allStrokes[allStrokes.length - 1];const preview = lastStroke.slice(0, 5).map(p = `(${p.x.toFixed(1)}, ${p.y.toFixed(1)})`).join(', ');const logEntry = `div[Stroke ${allStrokes.length}] Points: ${lastStroke.length} | Preview: ${preview}.../div`;dataLog.innerHTML = logEntry + dataLog.innerHTML;// 限制日志长度if (dataLog.children.length 20) {dataLog.removeChild(dataLog.lastChild);}}// 绑定事件canvas.addEventListener('mousedown', startDrawing);canvas.addEventListener('mousemove', moveDrawing);canvas.addEventListener('mouseup', endDrawing);canvas.addEventListener('mouseout', endDrawing); // 鼠标移出画布也结束canvas.addEventListener('touchstart', startDrawing, { passive: false });canvas.addEventListener('touchmove', moveDrawing, { passive: false });canvas.addEventListener('touchend', endDrawing);// 清除按钮btnClear.addEventListener('click', () = {ctx.clearRect(0, 0, canvas.width, canvas.height);allStrokes = [];currentStroke = [];dataLog.innerHTML = '已清除，请重新书写';});/script
/body
/html代码解读关键点：数据结构 allStrokes：这是一个二维数组。外层数组的每个元素代表一个笔画，内层数组是该笔画的所有坐标点 {x, y, t}。这是后端算法模型最通用的输入格式。
shouldRecordPoint 函数：这里实现了简单的欧几里得距离计算。只有当鼠标移动距离超过 3 像素时才记录。这大大减少了数据冗余。
STROKE_BREAK_TIME：我设了 300ms。如果你发现用户写得比较慢，导致一个字被拆成好几个笔画，可以调大这个值；如果用户写得很快，停顿很短，可以调小。这个参数需要根据实际用户习惯调试。
touch-action: none：在 CSS 里加上这一行非常重要。否则在手机上，手指滑动画布时，页面会跟着滚动，导致捕捉中断。常见报错：这些坑我替你踩过了线条抖动/锯齿严重原因：采样频率太低，或者 lineCap 设置不对。
解决：确保 ctx.lineCap = 'round' 和 ctx.lineJoin = 'round'。如果还抖，适当降低 MIN_DISTANCE 阈值，比如改成 2 像素。数据量太大，JSON 序列化卡顿原因：t (时间戳) 是毫秒级的大数，x y 是浮点数，数据精度太高。
解决：在发送给后端前，对数据做归一化和量化。归一化：将所有坐标除以画布尺寸，变成 0-1 之间的小数。
量化：保留 2-3 位小数即可，比如 x.toFixed(2)。
时间戳：只记录相对时间（相对于该笔画起点的毫秒数），而不是绝对时间，数值会小很多。移动端多点触控冲突原因：用户不小心用了两根手指。
解决：在 startDrawing 中，如果 e.touches.length 1，直接 return，不处理。只响应单指操作。Canvas 在 Retina 屏上模糊原因：CSS 尺寸和 Canvas 内部像素尺寸不一致。
解决：在 JS 初始化时，检测 window.devicePixelRatio，将 Canvas 的 width 和 height 属性乘以这个比例，然后调用 ctx.scale(ratio, ratio)。虽然这步对“数据捕捉”影响不大（因为坐标逻辑没变），但对“视觉反馈”很重要，用户体验好了，才愿意多写几个字。小结与互动
回顾一下，手写汉字识别的前端部分，其实就三步：捕获：用鼠标/触摸事件拿到坐标。
清洗：通过距离和时间过滤噪点，切分笔画。
传输：将标准化的 [ {x,y,t} ] 数组发给后端。这看似简单的过程，包含了大量的工程细节。从掘金技术社区那些高分项目的源码来看，真正让识别率提升 5% 的，往往不是模型换了，而是前端的数据预处理做得更精细。比如对笔画的平滑处理（贝塞尔曲线拟合）、对倒序笔画的纠正等。
对于转岗的前端工程师来说，理解这部分逻辑，能让你从“只会调 API”变成“懂业务数据流”的开发者。当你能亲手写出这个捕捉模块，再去对接算法接口时，你对数据结构的理解会深刻得多，排查 bug 的速度也会快得多。
代码我已经贴出来了，建议你动手跑一遍。把 MIN_DISTANCE 改成 1，再看看线条的变化；把 STROKE_BREAK_TIME 改成 100ms，看看笔画切分的效果。参数调优是工程落地的必修课。
这个知识点你面试被问过吗？ 尤其是关于“前端如何优化高频事件数据处理”或者“Canvas 性能优化”的问题，留言说说你的经历，或者你遇到的奇葩 Bug，咱们一起避坑。 3分钟搞懂手写汉字识别,前端转岗必看的实战细节
3分钟搞懂手写汉字识别,前端转岗必看的实战细节
官方文档翻了三遍还是头大？别慌，我当年转行做前端时，被手写实现汉字识别这个需求卡得死死的。那时候我就想，为什么非要搞这么复杂？其实核心逻辑没那么玄乎。
今天就把压箱底的经验掏出来。不聊那些虚的理论，直接上代码，带你从零搭建一个能跑通的手写汉字识别 Demo。不管你是刚入行的小白，还是想拓展技能树的前端老哥，这篇能帮你把手写汉字这块硬骨头啃下来。
概念速懂：别被术语吓跑
很多人一听“手写汉字识别”，脑子里全是深度学习、CNN、RNN这些高大上的词。先冷静，我们从最基础的视角看。
在前端开发场景里，我们通常不直接训练模型（那是后端或算法工程师的事），我们要做的是数据采集和前端预处理。简单说，就是用户在屏幕或触控板上写一个字，你要把这一笔一划变成计算机能懂的数据格式，然后发给后端去识别，或者调用 API 返回结果。
这里有个关键概念：笔画轨迹。
计算机不认识“字”，它只认识“点”。当用户手指划过屏幕，我们要记录下的不是“这是一个横”，而是 (x1, y1, t1), (x2, y2, t2) 这样的坐标和时间戳序列。
为什么时间戳 t 重要？因为手写有时序性。写“人”字，先撇后捺；写“大”字，先横后撇再捺。如果只给一堆散点，计算机分不清这是“人”还是“入”，甚至可能是乱码。所以，手写实现的核心，就是高精度地捕捉并清洗这些带时间戳的坐标数据。
在掘金技术社区上看到不少前端大佬分享过类似项目，大家普遍遇到的第一个坑就是：采样频率太低，线条断断续续；或者频率太高，数据量爆炸，传输卡顿。怎么平衡？这就是下面我们要解决的环境准备问题。
环境准备：别用错工具
既然面向前端转岗，咱们就用最熟悉的技术栈：HTML5 Canvas + 原生 JavaScript。
为什么不用 Vue 或 React？因为底层交互逻辑是一样的，框架只会增加理解成本。等你用原生跑通了，迁移到框架里也就是封装个组件的事。
你需要准备的环境很简单：一个支持 HTML5 Canvas 的浏览器（Chrome、Firefox 均可）。
一个本地服务器（如 VS Code 的 Live Server 插件），因为直接双击打开 HTML 文件，某些 API 可能会受限。
如果要在手机上测试，确保你的开发设备支持触摸事件（Touch Events）。这里有个小细节：Canvas 的默认坐标系原点在左上角，x 轴向右，y 轴向下。这点和数学坐标系（y 轴向上）是反的，新手写变换逻辑时容易在这里栽跟头，心里有个数就行。
另外，关于手写汉字的字体渲染，我们不需要加载字体文件。因为我们要记录的是用户的“笔迹”，而不是“打印字”。用户写的是草书还是楷书，那是算法模型要适配的，前端只负责如实记录。
核心语法：抓住这三个 API
要手写实现轨迹捕捉，重点就三个 API：getContext('2d')、requestAnimationFrame、addEventListener。
别被名字唬住，我拆开讲：canvas.getContext('2d')
这是获取绘图上下文的钥匙。没有它，Canvas 就是个空盒子。我们需要用到它的 beginPath()、moveTo()、lineTo() 和 stroke() 方法来绘制线条。但注意，我们的目的不是“画出来给用户看”，而是“记录下来给算法用”。绘图只是为了视觉反馈，让用户知道“我写上了”。addEventListener (触摸/鼠标事件)
这是数据入口。桌面端：监听 mousedown（按下）、mousemove（移动）、mouseup（抬起）。
移动端：监听 touchstart、touchmove、touchend。
坑点：mousemove 和 touchmove 的触发频率非常高，有时候一秒钟能触发几十次甚至上百次。如果你每次触发都存数据，数组会瞬间膨胀。requestAnimationFrame
这是性能优化的神器。它不是用来监听事件的，而是用来控制绘制频率的。但在这里，我们可以借它的思路来理解“帧”的概念。真正的优化策略是：在事件监听器里，不要立刻保存所有坐标，而是先暂存，或者进行抽稀（Thinning）。什么是抽稀？就是去掉那些“差不多”的点。比如，如果两个相邻点的距离小于 2 像素，且时间间隔小于 5 毫秒，第二个点就可以丢弃。这样既保证了线条平滑，又控制了数据量。
还有一个关键点：笔画切分。用户写“王”字，中间可能停顿一下。如果停顿时间超过 300 毫秒，前端应该判定为“新笔画开始”，在数据结构里开一个新数组。否则，算法会把停顿后的笔迹当成同一笔画的抖动，识别率直接崩盘。
完整代码示例：跑起来才叫懂
光说不练假把式。下面这段代码，你可以直接复制到 HTML 里运行。它实现了基本的笔画捕捉、实时绘图和数据结构存储。
!DOCTYPE html
html lang=zh-CN
headmeta charset=UTF-8meta name=viewport content=width=device-width, initial-scale=1.0title手写汉字轨迹捕捉 Demo/titlestylebody {display: flex;flex-direction: column;align-items: center;justify-content: center;height: 100vh;margin: 0;background-color: #f0f0f0;font-family: sans-serif;}#canvas-container {position: relative;}canvas {background-color: white;border: 2px solid #333;cursor: crosshair;/* 防止移动端触摸时的默认滚动行为 */touch-action: none; }#btn-clear {margin-top: 20px;padding: 10px 20px;font-size: 16px;cursor: pointer;}#data-log {margin-top: 20px;width: 80%;height: 150px;overflow-y: auto;background: #222;color: #0f0;padding: 10px;font-family: monospace;font-size: 12px;border-radius: 4px;}/style
/head
bodydiv id=canvas-container!-- 设置画布大小，注意 CSS 大小和 Canvas 内部像素要一致，否则模糊 --canvas id=writeCanvas width=300 height=300/canvas
/divbutton id=btn-clear清除画布/button
div id=data-log点击“清除”后开始书写，数据将显示在此.../divscriptconst canvas = document.getElementById('writeCanvas');const ctx = canvas.getContext('2d');const dataLog = document.getElementById('data-log');const btnClear = document.getElementById('btn-clear');// 核心数据结构：存储所有笔画// 结构: [ [ {x, y, t}, {x, y, t}, ... ], [ ... ] ]let allStrokes = []; let currentStroke = [];let isDrawing = false;let lastTimestamp = 0;let lastPoint = { x: 0, y: 0 };// 配置参数const MIN_DISTANCE = 3; // 最小记录距离(像素)，用于抽稀const STROKE_BREAK_TIME = 300; // 笔画断开的时间阈值(毫秒)/*** 获取事件坐标，兼容鼠标和触摸*/function getCoords(e) {const rect = canvas.getBoundingClientRect();let clientX, clientY;if (e.touches e.touches.length 0) {clientX = e.touches[0].clientX;clientY = e.touches[0].clientY;} else {clientX = e.clientX;clientY = e.clientY;}// 减去画布在页面中的偏移，得到相对于画布的坐标return {x: clientX - rect.left,y: clientY - rect.top};}/*** 判断是否需要记录新点（抽稀算法）*/function shouldRecordPoint(newPoint) {const distance = Math.sqrt(Math.pow(newPoint.x - lastPoint.x, 2) + Math.pow(newPoint.y - lastPoint.y, 2));// 如果距离足够远，或者距离近但时间间隔较长（防止抖动），则记录return distance MIN_DISTANCE;}/*** 开始绘制/捕捉*/function startDrawing(e) {e.preventDefault(); // 阻止默认行为，如页面滚动isDrawing = true;// 如果距离上次结束时间很短，可能是误触或连续笔画，这里简单处理：新开一个笔画// 实际项目中可根据 lastTimestamp 判断是否延续上一笔画currentStroke = [];const coords = getCoords(e);const now = Date.now();// 初始化最后一点lastPoint = coords;lastTimestamp = now;// 记录第一个点currentStroke.push({ x: coords.x, y: coords.y, t: now });// 绘制起点ctx.beginPath();ctx.moveTo(coords.x, coords.y);}/*** 移动/捕捉中间点*/function moveDrawing(e) {if (!isDrawing) return;e.preventDefault();const coords = getCoords(e);const now = Date.now();// 检查是否发生笔画断开（停顿过长）if (now - lastTimestamp STROKE_BREAK_TIME) {// 结束当前笔画，存入总集合if (currentStroke.length 1) {allStrokes.push(currentStroke);updateLog();}currentStroke = [];ctx.beginPath(); // 断开线条}// 抽稀判断if (shouldRecordPoint(coords)) {currentStroke.push({ x: coords.x, y: coords.y, t: now });// 实时绘制，给用户视觉反馈ctx.lineTo(coords.x, coords.y);ctx.strokeStyle = 'black';ctx.lineWidth = 4;ctx.lineCap = 'round';ctx.stroke();// 更新参考点lastPoint = coords;lastTimestamp = now;}}/*** 结束绘制/捕捉*/function endDrawing(e) {if (!isDrawing) return;isDrawing = false;// 将最后一笔存入总集合if (currentStroke.length 1) {allStrokes.push(currentStroke);updateLog();}currentStroke = [];}/*** 更新日志显示，模拟发送给后端的数据*/function updateLog() {// 这里只打印最后一条笔画的前5个点，避免日志过长const lastStroke = allStrokes[allStrokes.length - 1];const preview = lastStroke.slice(0, 5).map(p = `(${p.x.toFixed(1)}, ${p.y.toFixed(1)})`).join(', ');const logEntry = `div[Stroke ${allStrokes.length}] Points: ${lastStroke.length} | Preview: ${preview}.../div`;dataLog.innerHTML = logEntry + dataLog.innerHTML;// 限制日志长度if (dataLog.children.length 20) {dataLog.removeChild(dataLog.lastChild);}}// 绑定事件canvas.addEventListener('mousedown', startDrawing);canvas.addEventListener('mousemove', moveDrawing);canvas.addEventListener('mouseup', endDrawing);canvas.addEventListener('mouseout', endDrawing); // 鼠标移出画布也结束canvas.addEventListener('touchstart', startDrawing, { passive: false });canvas.addEventListener('touchmove', moveDrawing, { passive: false });canvas.addEventListener('touchend', endDrawing);// 清除按钮btnClear.addEventListener('click', () = {ctx.clearRect(0, 0, canvas.width, canvas.height);allStrokes = [];currentStroke = [];dataLog.innerHTML = '已清除，请重新书写';});/script
/body
/html代码解读关键点：数据结构 allStrokes：这是一个二维数组。外层数组的每个元素代表一个笔画，内层数组是该笔画的所有坐标点 {x, y, t}。这是后端算法模型最通用的输入格式。
shouldRecordPoint 函数：这里实现了简单的欧几里得距离计算。只有当鼠标移动距离超过 3 像素时才记录。这大大减少了数据冗余。
STROKE_BREAK_TIME：我设了 300ms。如果你发现用户写得比较慢，导致一个字被拆成好几个笔画，可以调大这个值；如果用户写得很快，停顿很短，可以调小。这个参数需要根据实际用户习惯调试。
touch-action: none：在 CSS 里加上这一行非常重要。否则在手机上，手指滑动画布时，页面会跟着滚动，导致捕捉中断。常见报错：这些坑我替你踩过了线条抖动/锯齿严重原因：采样频率太低，或者 lineCap 设置不对。
解决：确保 ctx.lineCap = 'round' 和 ctx.lineJoin = 'round'。如果还抖，适当降低 MIN_DISTANCE 阈值，比如改成 2 像素。数据量太大，JSON 序列化卡顿原因：t (时间戳) 是毫秒级的大数，x y 是浮点数，数据精度太高。
解决：在发送给后端前，对数据做归一化和量化。归一化：将所有坐标除以画布尺寸，变成 0-1 之间的小数。
量化：保留 2-3 位小数即可，比如 x.toFixed(2)。
时间戳：只记录相对时间（相对于该笔画起点的毫秒数），而不是绝对时间，数值会小很多。移动端多点触控冲突原因：用户不小心用了两根手指。
解决：在 startDrawing 中，如果 e.touches.length 1，直接 return，不处理。只响应单指操作。Canvas 在 Retina 屏上模糊原因：CSS 尺寸和 Canvas 内部像素尺寸不一致。
解决：在 JS 初始化时，检测 window.devicePixelRatio，将 Canvas 的 width 和 height 属性乘以这个比例，然后调用 ctx.scale(ratio, ratio)。虽然这步对“数据捕捉”影响不大（因为坐标逻辑没变），但对“视觉反馈”很重要，用户体验好了，才愿意多写几个字。小结与互动
回顾一下，手写汉字识别的前端部分，其实就三步：捕获：用鼠标/触摸事件拿到坐标。
清洗：通过距离和时间过滤噪点，切分笔画。
传输：将标准化的 [ {x,y,t} ] 数组发给后端。这看似简单的过程，包含了大量的工程细节。从掘金技术社区那些高分项目的源码来看，真正让识别率提升 5% 的，往往不是模型换了，而是前端的数据预处理做得更精细。比如对笔画的平滑处理（贝塞尔曲线拟合）、对倒序笔画的纠正等。
对于转岗的前端工程师来说，理解这部分逻辑，能让你从“只会调 API”变成“懂业务数据流”的开发者。当你能亲手写出这个捕捉模块，再去对接算法接口时，你对数据结构的理解会深刻得多，排查 bug 的速度也会快得多。
代码我已经贴出来了，建议你动手跑一遍。把 MIN_DISTANCE 改成 1，再看看线条的变化；把 STROKE_BREAK_TIME 改成 100ms，看看笔画切分的效果。参数调优是工程落地的必修课。
这个知识点你面试被问过吗？ 尤其是关于“前端如何优化高频事件数据处理”或者“Canvas 性能优化”的问题，留言说说你的经历，或者你遇到的奇葩 Bug，咱们一起避坑。