HTML本身不支持直接生成DataMatrix码，因其无原生标签或API；所有实现均依赖JS库（如datamatrix-js、datamatrix-svg）或服务端渲染，且qrcode.js等QR专用库不支持DataMatrix。
HTML 本身不支持直接生成 DataMatrix 码——它没有原生的 <datamatrix> 标签，也不在 Canvas 2D API 或 CSS 规范中定义该码制。所有“HTML 生成 DataMatrix”的实际方案，都依赖外部 JavaScript 库或服务端渲染。
为什么不能用 qrcode.js 生成 DataMatrix
qrcode.js（包括其常见变体如 qrcode-generator、qrcode.react）只支持 QR Code，**不支持 DataMatrix**。它的核心算法、编码表、纠错逻辑、符号尺寸规则全部针对 QR 标准设计。尝试传入 type: 'datamatrix' 会静默失败或抛出 Unknown type 错误。
常见错误现象：
- 控制台报错
Uncaught Error: Invalid type: datamatrix - 页面空白，
<canvas>无内容，但无任何提示 - 生成了看似二维码的图案，但扫描器识别为“无效格式”或直接拒识
原因很简单：DataMatrix 和 QR 是两种完全独立的 ISO/IEC 标准（分别是 ISO/IEC 16022 和 ISO/IEC 18004），编码结构、模块排布、纠错机制互不兼容。
立即学习“前端免费学习笔记（深入）”；
前端可用的 DataMatrix JS 库只有这几个
目前稳定、轻量、可直接在浏览器运行的开源 DataMatrix 库极少，真正可用的只有：
-
datamatrix-js：基于 TypeScript 编写，支持 UCC/EAN.GS1 模式，输出<canvas>或Uint8Array；需注意它默认不处理GS（ASCII 29）字符，GS1 场景必须手动替换为\u001D -
js-datamatrix：较老，仅支持 ASCII 子集，不支持长方形尺寸或 GS1 结构化数据，已停止维护 -
datamatrix-svg：纯 SVG 输出，适合打印，但不支持纠错级别调节，对中文等多字节字符支持弱
示例（使用 datamatrix-js）：
import { encode } from 'datamatrix-js';
const data = '\u001D0101234567890128\u001D10ABCD'; // GS1 示例，\u001D = GS
const matrix = encode(data, { size: 'default', shape: 'square' });
const canvas = document.getElementById('dm-canvas');
const ctx = canvas.getContext('2d');
ctx.clearRect(0, 0, canvas.width, canvas.height);
matrix.draw(ctx, 0, 0, canvas.width, canvas.height);
⚠️ 注意：size: 'default' 并非固定值，它会根据输入长度自动选择最小可行版本（如 10x10、12x12…144x144），无法强制指定；若内容超限，encode() 会抛出 Error: Data too long for symbol size。
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。
GS1 DataMatrix 必须手动注入 GS 字符
GS1 标准要求字段分隔符使用 ASCII 29（Group Separator，GS），不是换行符 \n，也不是反斜杠加字母 \GS。很多用户在前端拼接字符串时直接写 '01' + ai + '\n10' + lot，结果扫码器读出的是乱码或截断数据。
正确做法：
- 用
\u001D或String.fromCodePoint(0x1D)表示 GS - 确保整个字符串 UTF-8 编码后仍符合 DataMatrix 的字符集限制（推荐先转为 ASCII 兼容模式，如 C40 或 Text 编码）
- 若使用
datamatrix-js，它默认启用 Auto 模式选编码，但遇到混合大小写+数字时可能选错——建议显式指定encoding: 'text'或'c40'
错误示例：'01123456789012810ABCD'（无 GS）→ 扫码器无法解析应用标识符；'011234567890128\n10ABCD'（用 \n 代替 GS）→ 多数工业扫描器直接忽略该字段。
长方形 DataMatrix 在前端渲染容易变形
DataMatrix 支持矩形尺寸（如 8x18、12x30），但前端 Canvas 渲染时，若未严格按模块比例缩放，会导致黑白模块被拉伸，降低扫码成功率。
关键点：
- Canvas 的
width/height必须是模块数的整数倍（例如 12×30 模块，canvas 尺寸应设为120×300，每模块 10px） - 禁用 CSS 缩放：
canvas { width: 100%; height: auto; }会破坏模块等比性，必须用内联width/height属性 -
datamatrix-js的draw()方法不自动适配矩形——需手动计算目标宽高比，否则默认按正方形填充
最稳妥的方式：生成 SVG（矢量），而非 Canvas 或 PNG。SVG 能无损缩放，且可直接嵌入 HTML：<div><svg>...</svg></div>。但要注意部分老旧扫码枪对 SVG 渲染的灰度反差敏感，需确保 black 模块用 #000，white 背景用 #fff，避免透明背景。
真正难的不是“怎么画出来”，而是让产线扫码器在油污、反光、小尺寸金属件上稳定识别——这取决于字符编码是否合规、GS 是否到位、模块尺寸是否匹配硬件最小分辨率，以及纠错等级是否覆盖实际工况。前端能做的有限，关键决策点往往在数据构造阶段就已锁定。
