在鸿蒙（HarmonyOS）应用开发中，表单验证是保障数据质量和系统安全的第一道防线。无论是用户注册、支付信息录入还是日志分析，都需要对输入的字符串进行严格的合法性校验。

鸿蒙生态提供了从底层正则表达式到高层封装工具库的多种解决方案，帮助开发者高效、安全地完成数据验证。

一、 主流验证工具库概览

1. harmony-utils (RegexUtil)：鸿蒙开发中极受欢迎的第三方工具库。其 RegexUtil 封装了大量高频正则常量（如 URL、数字、身份证号、时间等），并提供了 isMatch、isPhone、isEmail、isValidCard 等开箱即用的方法，极大简化了表单校验逻辑。
2. ef-tool：一款功能丰富的鸿蒙工具包，内置了常见验证场景（如手机号、邮箱、密码等）的正则表达式。开发者无需手动编写复杂的正则，直接调用即可，同时它还集成了 Toast、Dialog 等 UI 组件，方便在校验失败时给出提示。
3. validated (Flutter for OpenHarmony)：专为鸿蒙 Flutter 开发打造的全业务场景校验方案。它不仅提供校验（Validators），还聚合了清洗（Sanitizers）能力，支持 blacklist（黑名单过滤）、escape 等操作，能有效防止 XSS 注入攻击，是构建“数据可信”应用的核心安检站。
4. KMP OpenHarmony 正则工具库：基于 Kotlin Multiplatform 技术，确保在 Kotlin/JVM、Kotlin/JS 以及 ArkTS 调用时，正则表达式处理的逻辑和结果完全一致，非常适合跨平台项目。

二、 核心封装能力与最佳实践

优秀的验证库通常具备以下核心能力：

• 预置工业级正则常量：内置覆盖 40+ 种高频场景的校验规则（如 IP、Base64、HexColor、JSON 结构等），避免开发者重复造轮子。
• 数据清洗与脱敏：在验证通过后，自动对输入数据进行 trim、黑名单过滤等操作，确保进入业务逻辑或数据库的数据是干净且安全的。
• 性能优化与缓存：对于频繁使用的正则表达式，工具库内部会进行预编译和缓存，避免重复解析带来的性能损耗。
• 安全防护：内置正则表达式 DoS（拒绝服务）防护机制，在处理用户输入的正则时进行验证，防止恶意构造的复杂正则拖垮系统。

三、 工程级避坑与最佳实践

1. 正则预编译与缓存：在频繁使用相同的正则表达式时，务必预先编译并缓存正则对象，或在处理大量文本时采用批量处理方式，以显著提高运行效率。
2. 防范正则 DoS 攻击：在处理用户输入的正则表达式时，必须警惕正则表达式拒绝服务攻击，避免使用过于复杂或存在回溯陷阱的正则。
3. 结合 UI 组件联动：表单验证不应仅停留在逻辑层，应与 UI 紧密联动。例如在输入框失去焦点（@blur）时触发校验，并动态显示错误提示文案，提供极致的交互体验。
4. 区分校验与清洗：将“判断是否合法”与“清理非法字符”分离。先通过 Validators 进行合法性判定，再调用 Sanitizers 进行数据清洗，最后将可信数据持久化或传递给后端。

四、 原生实战：构建全局正则配置池

场景：在不引入第三方库的情况下，通过定义一个包含常用正则表达式的配置对象（如身份证、手机号、密码强度等），在业务代码中直接调用，避免重复造轮子。

// 定义全局正则配置池
const regExpConfig = {
    mobile: /^1[3-9]\d{9}$/,             // 手机号码
    IDcard: /^[1-9]\d{5}[1-9]\d{3}((0\d)|(1[0-2]))(([0|1|2]\d)|3[0-1])\d{3}([0-9]|X)$/, // 身份证
    pwd: /^[0-9A-Za-z]{6,16}$/,          // 6-16位数字或字母密码
    isEmail: /^[^\s@]+@[^\s@]+\.[^\s@]+$/ // 邮箱格式
};

// 封装通用校验方法
function isValid(ruleName: keyof typeof regExpConfig, value: string): boolean {
    return regExpConfig[ruleName].test(value);
}

// 业务调用
console.info('手机号校验:', isValid('mobile', '13800138000')); // true

五、通用验证器工具类实战：声明式规则配置

场景：在复杂的表单场景中，将验证逻辑与 UI 解耦。通过封装一个 Validator 类，支持必填、长度限制、正则匹配等规则的链式组合与复用。

// 通用验证器工具类
export class Validator {
    static required(message: string = '此字段为必填项'): { validate: (v: string) => string | null } {
        return { validate: (v) => (!v || !v.trim()) ? message : null };
    }

    static pattern(regex: RegExp, message: string = '格式不正确'): { validate: (v: string) => string | null } {
        return { validate: (v) => !regex.test(v) ? message : null };
    }

    static phone(message: string = '请输入有效的手机号码') {
        return this.pattern(/^1[3-9]\d{9}$/, message);
    }
}

// 业务配置与调用
const rules = [
    Validator.required('请输入手机号'),
    Validator.phone()
];

const errorMsg = rules.map(r => r.validate('12345')).find(msg => msg !== null);
console.info('校验结果:', errorMsg); // 输出: 请输入有效的手机号码

六、 UI 联动实战：TextInput 实时校验与反馈

场景：结合鸿蒙的 TextInput 组件，在用户输入时（onChange）实时触发正则校验，并动态展示错误提示或控制提交按钮的禁用状态。

@Entry
@Component
struct RegisterForm {
    @State phone: string = '';
    @State err: string = '';

    private checkPhone(v: string) {
        this.phone = v;
        // 实时正则校验
        if (v && !/^1[3-9]\d{9}$/.test(v)) {
            this.err = '请输入正确的11位手机号';
        } else {
            this.err = ''; // 校验通过清空错误
        }
    }

    build() {
        Column({ space: 10 }) {
            TextInput({ placeholder: '请输入手机号' })
                .type(InputType.PhoneNumber) // 自动弹出数字键盘
                .onChange((v) => this.checkPhone(v))
            
            if (this.err) {
                Text(this.err).fontSize(12).fontColor('#E53935') // 红色错误提示
            }

            Button('提交').enabled(this.err === '' && this.phone.length === 11)
        }.padding(20)
    }
}

七、跨平台与第三方库集成实战

场景：在鸿蒙 Flutter 跨平台项目中使用 regexed_validator，或在鸿蒙原生项目中通过 OHPM 引入 @yunkss/eftool 等成熟工具库，快速实现结构化校验。

// 方案 A：鸿蒙原生引入 OHPM 三方库（如 eftool）
import { eftool } from '@yunkss/eftool';
const isPhoneValid = eftool.isPhone('13800138000');

// 方案 B：Flutter for OpenHarmony 使用 regexed_validator
// import 'package:regexed_validator/regexed_validator.dart';
// bool isValid = validator.email('test@example.com');