如何从零实现轻量表单校验库,轻量表单校验库怎么实现?
一个够用的轻量表单校验库,核心只有三件东西:规则表、执行器、错误池,两百来行代码就能跑通。真正的难点不在写,而在异步校验的竞态处理和错误提示的颗粒度控制——这两块做不好,代码再短也是半成品。
先想清楚:你到底该不该自己写
很多人的第一反应是找个现成库。但在动手之前,有三个问题值得先回答一下。
三个自研判断标准
- 表单字段是不是集中在十几个以内,且业务流程强绑定?如果是,引入一个大而全的库反而增加心智负担。
- 校验规则是不是以业务规则为主,比如“身份证后四位与手机号后四位不能相同”这种?通用库基本帮不上忙。
- 项目是不是长期维护,团队里有人能把控这几百行代码?如果是一次性活动页,直接用原生的
required加几行判断更快。
反过来说,如果表单是 Schema 驱动的、字段几十上百个、还要做 TypeScript 类型推导,那 zod 这类方案更省事。自己写库的收益,主要落在“可裁剪”和“能改”这两点上。
表单校验库实现原理:规则表、执行器、错误池
剥掉所有封装,一个校验库干的事非常朴素:拿到一个值,对着一串规则挨个跑,第一个不通过的就把消息记下来。
第一层:规则表长什么样
规则表就是普通对象,key 是字段名,value 是规则数组。每条规则只描述两件事——怎么判断、失败了说什么。
const rules = {
required: (v) => (v !== '' && v != null) || '该项必填',
min: (v, n) => v.length >= n || `至少 ${n} 个字符`,
pattern: (v, re) => re.test(v) || '格式不正确',
};
const schema = {
phone: [
{ type: 'required', message: '请输入手机号' },
{ type: 'pattern', value: /^1[3-9]d{9}$/, message: '手机号格式不对' },
],
};
第二层:执行器怎么串起来
执行器是一个函数,输入字段名和值,输出错误信息(空字符串代表通过)。注意它必须支持 async,因为远程查重、验证码校验这类场景绕不开。
async function runRules(list, value) {
for (const rule of list) {
const res = rule.type === 'validator'
? await rule.value(value)
: rules[rule.type](value, rule.value);
if (res !== true) return rule.message || res;
}
return '';
}
这里用 for...of 顺序执行而不是 Promise.all,是刻意的。规则有优先级,required 没过就不该再跑正则,不然用户会在空输入框上看到“手机号格式不对”,体验很糟糕。
第三层:错误池与渲染
错误池就是一个 Map,字段名映射到错误文案。渲染层订阅这个 Map 的变化,字段有错就插入提示节点,没错就移除。别每次校验都重刷整个表单,那种闪烁会被用户当成 bug。
动手实现:从空目录到可用版本
初始化与目录
mkdir tiny-form && cd tiny-form
npm init -y
mkdir src && touch src/index.js
不装任何依赖。构建工具用 vite 或者干脆不构建,直接 引进去也能跑,本地调试可以起一个 npx serve .。
加上异步竞态保护
这是整个库里最容易写错的地方。用户在手机号输入框里连续输入,每次失焦都触发一次远程校验,请求回来的顺序不保证。你如果不做处理,先发的慢请求后回来,就会把正确结果覆盖成错误结果。
const seq = {};
async function validateField(name, value) {
const id = (seq[name] = (seq[name] || 0) + 1);
const msg = await runRules(schema[name] || [], value);
if (seq[name] !== id) return; // 已过期,直接丢弃
msg ? errors.set(name, msg) : errors.delete(name);
render(name);
}
一个自增序号就能解决九成的“异步校验结果错乱”问题,比 AbortController 简单,也不依赖网络层。
接到真实表单上
blur事件里做字段级校验,只跑当前字段的规则;input事件里只做“错误清除”,不重新校验,避免用户打字过程中红字乱跳;submit里跑全量,任一字段不通过就preventDefault并把焦点移到第一个错误字段。
全量校验可以用 Promise.all 并发,各字段之间互不依赖,没必要排队。
轻量表单校验库和 validate.js 对比,差在哪
网上讨论最多的老牌方案是 validate.js,很多人拿它做基准。把几类方案摆在一起看会更清楚。
| 维度 | 自研轻量库 | validate.js | async-validator | zod |
|---|---|---|---|---|
| 产物体积 | 个位数 KB | 十 KB 量级 | 中等 | 中等偏大 |
| 异步校验 | 自己加,写法自由 | 支持但写法绕 | 支持 | 支持 |
| 类型推导 | 取决于自己的 TS 功底 | 无 | 一般 | 很强 |
| 业务定制 | 随便改 | 需二次封装 | 需二次封装 | 中等 |
| 合适场景 | 中小型业务表单 | 静态页面、老项目 | 组件库配套 | Schema 驱动、TS 项目 |
免费开源表单校验库能上生产吗
这个问题本质上不是“免费”的事,而是“维护成本”的事。用现成库,成本在后期的版本升级和二次封装;自己写,成本在前期的规则抽象和测试覆盖。业内专家指出,前端基础设施的选型核心从来不是功能多少,而是出问题时你能不能在两小时内定位。
自研库是零成本的,代价是你得自己写单元测试。建议至少覆盖三类用例:空值、边界长度、异步返回顺序颠倒。这三类过了,生产环境基本不会出大问题。
国内前端团队常见的三种做法
做前端咨询这几年接触下来,国内团队处理表单校验大致分三派:一是直接用组件库自带的表单校验,省事但绑死了 UI 框架;二是包装 async-validator 这类底层库,保留灵活性;三是像本文这样自研一层。行业共识认为,业务规则越垂直,自研的性价比越高。
几个容易踩的坑
错误提示抖动
用户输入一个字就校验一次,红字一闪一闪。解决办法是区分“首次校验时机”和“后续校验时机”:字段一开始没被碰过,input 时不校验;一旦失焦报过错,后续 input 就可以实时清错。这个状态用一个 touched 集合记录即可。
大表单的性能
字段数量上去以后,逐个 document.querySelector 会明显变慢。据统计,字段数破百的表单里,选择器查询往往是瓶颈而非规则计算本身。做法很简单:初始化时把字段节点一次性收进 Map 缓存,后续只查内存。另外错误提示不要用 innerHTML 整体重写,改成已有节点改文本、没有节点再插入。
规则复用的边界
别把“字段 A 依赖字段 B”的逻辑塞进规则表。规则只该回答“这个值合不合法”,跨字段比较属于表单级校验,单独写一个函数在 submit 前跑一次,代码会干净很多。
文档比代码更值得花时间:用 Mermaid 画校验流程
这类小库最尴尬的地方是半年后没人记得它怎么运转。代码实践之外,我的习惯是在 README 里放一张时序图,比十段文字管用。
sequenceDiagram
participant U as 用户
participant F as 表单
participant V as 校验器
participant S as 服务端
U->>F: 输入手机号并失焦
F->>V: validateField('phone', value)
V->>V: 顺序执行 required / pattern
V->>S: 异步规则(可选)
S-->>V: 返回结果
V-->>F: 错误信息或空
F->>U: 渲染提示
Mermaid 的好处是写在 Markdown 里就能渲染,GitHub、语雀、飞书文档都认。图里把“顺序执行”和“异步可选”两处标出来,后来接手的人一眼就知道哪里能扩展。图表绘制的投入产出比,在内部工具类项目上往往高于代码本身。
登录注册页表单校验怎么做
这是绝大多数人第一次写校验库的场景。给几条具体建议:手机号用正则前置判断,长度不对就别发请求;验证码字段加 maxlength,输满自动提交校验;密码强度提示用 change 事件实时算,不要等提交才告诉用户不合格;提交按钮在请求期间置灰,防止重复提交——这个不属于校验,但漏掉它,前面做的所有校验都白搭。
把这套东西抽出来之后,代码量大概就是两百行出头,gzip 后进不了十 KB 的门槛。后续新业务要加规则,往 rules 对象里塞一个函数就行,不用动执行逻辑。
表单校验库相关问答
自研表单校验库大概要投入多少人天?
核心代码一到两天能写完,真正吃时间的是测试用例和文档。保守估计,一个能稳定上线的版本在两到三人天左右。如果团队里已有成熟的错误提示组件,还能再省一半。
什么时候该放弃自研,换回成熟库?
出现这三个信号就该换:字段规模超过几十个且规则高度动态、需要和 TypeScript 类型系统深度联动、团队里没人愿意接手维护。前两个是能力边界问题,第三个是组织问题,都不是靠加班能解决的。
轻量校验库和组件库自带校验能混用吗
可以,但要有明确分工。让组件库只管 UI 和错误展示的位置,校验逻辑统一走自己的执行器,规则表只维护一份。混用最常见的翻车方式是两套校验各报各的错,用户在同一个输入框上看到两条不同文案。