公告烟雨平生笔记 —— 内容持续更新,欢迎指正。

如何从零实现轻量表单校验库,轻量表单校验库怎么实现?

2026-11-22 代码实践 0 阅读

一个够用的轻量表单校验库,核心只有三件东西:规则表、执行器、错误池,两百来行代码就能跑通。真正的难点不在写,而在异步校验的竞态处理和错误提示的颗粒度控制——这两块做不好,代码再短也是半成品。

先想清楚:你到底该不该自己写

很多人的第一反应是找个现成库。但在动手之前,有三个问题值得先回答一下。

三个自研判断标准

  • 表单字段是不是集中在十几个以内,且业务流程强绑定?如果是,引入一个大而全的库反而增加心智负担。
  • 校验规则是不是以业务规则为主,比如“身份证后四位与手机号后四位不能相同”这种?通用库基本帮不上忙。
  • 项目是不是长期维护,团队里有人能把控这几百行代码?如果是一次性活动页,直接用原生的 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 或者干脆不构建,直接

保定九维网络科技有限公司 冀ICP备2026045612号-1