欢迎加入开源鸿蒙跨平台社区：https://openharmonycrossplatform.csdn.net

前言

在 OpenHarmony 应用开发中，我们有时会遇到需要处理自定义语法的场景。例如，用户在一个表单或高级编辑器中输入类似 (A + B) * log(5) 的数学表达式，或者我们需要解析一套自定义的 DSL 指令。

面对这类复杂的字符串逻辑，使用正则表达式往往会陷入“嵌套深、难维护、易出错”的泥潭。而 petitparser 正是为此设计的强大工具。它通过组合简单的解析器来构建复杂的语言解析引擎，让你可以像拼乐高积木一样定义语法规则，并将其直接转化为可执行的代码。

一、原理解析 / 概念介绍

1.1 基础概念

petitparser 的核心基于 解析表达式语法（PEG）。它不同于传统的词法分析器，而是将规则分解为最小的原子单元（如数字、字符、符号），再通过逻辑操作符进行组合。

1.2 映射操作（Action Mapping）

petitparser 最强大的地方在于它不仅能“验证”语法是否合规，还能在解析的过程中通过 .map() 方法直接执行业务逻辑。这意味着你可以在解析数字的同时将其转换为 int 类型，或者在解析加号规则时直接执行加法运算。它是构建微型编译器和解释器的核心利器。

二、核心 API / 组件详解

2.1 定义基础解析规则

只需几行代码即可定义一个能够处理空白字符并自动转型的数字解析器：

import 'package:petitparser/petitparser.dart';

void main() {
  // 定义数字解析规则：识别连续数字、去除两端空格并转为 int
  final numberRule = digit().plus().flatten().trim().map(int.parse);
  
  // 执行解析
  final result = numberRule.parse('    1205    ');
  print("解析结果: ${result.value}"); // 输出: 1205
}

三、场景示例

3.1 构建数学运算引擎

在财务或科学计算类鸿蒙应用中，动态解析数学公式是常见需求。使用 ExpressionBuilder 可以快速处理运算优先级。

import 'package:petitparser/petitparser.dart';

void calculateExpression() {
  final builder = ExpressionBuilder<num>();
  
  // 定义原子操作：数字（支持小数）
  builder.primitive(digit()
      .plus()
      .seq(char('.').seq(digit().plus()).optional())
      .flatten()
      .trim()
      .map(num.parse));
  
  // 优先级 1: 乘除
  builder.group()
    ..left(char('*').trim(), (a, op, b) => a * b)
    ..left(char('/').trim(), (a, op, b) => a / b);
    
  // 优先级 2: 加减
  builder.group()
    ..left(char('+').trim(), (a, op, b) => a + b)
    ..left(char('-').trim(), (a, op, b) => a - b);
    
  final parser = builder.build().end();
  final result = parser.parse('15 * 3 + 12 - 5');
  print("计算结果: ${result.value}"); // 输出: 52
}

四、鸿蒙适配建议

4.1 性能优化

虽然 petitparser 是纯 Dart 实现，无 native 依赖方案，但在处理数万行的超大文本解析时，建议将解析逻辑放入 异步任务（Isolate） 中执行。这样可以避免复杂的正则计算或递归解析阻碍 OpenHarmony 应用的主线程，确保界面滑动依然丝滑。

五、综合演示

以下是一个在鸿蒙应用中实现的完整数学公式解析 Demo，具备错误处理和 UI 反馈。

// ============================================================
// 文件：lib/petitparser/syntax_engine_5_1.dart
// 描述：综合语法解析引擎演示（带 UI 展示结果）
// 来源：《Flutter for OpenHarmony 实战》 - petitparser.md
// ============================================================

import 'package:flutter/material.dart';
import 'package:petitparser/petitparser.dart';

class SyntaxEnginePage extends StatefulWidget {
  const SyntaxEnginePage({super.key});

  @override
  State<SyntaxEnginePage> createState() => _SyntaxEnginePageState();
}

class _SyntaxEnginePageState extends State<SyntaxEnginePage> {
  String _radarLogDisplay = "系统未执行解析...";
  final TextEditingController _mathInputFieldObjCon =
      TextEditingController(text: " 15 + (12 * 3) - 6 ");

  void _triggerSeekAndAcquireValues() {
    final builder = ExpressionBuilder<num>();
    builder.primitive(digit()
        .plus()
        .seq(char('.').seq(digit().plus()).optional())
        .flatten()
        .trim()
        .map(num.parse));
    builder.group().wrapper(
        char('(').trim(), char(')').trim(), (left, value, right) => value);

    builder.group()
      ..left(char('*').trim(), (a, op, b) => a * b)
      ..left(char('/').trim(), (a, op, b) => a / b);
    builder.group()
      ..left(char('+').trim(), (a, op, b) => a + b)
      ..left(char('-').trim(), (a, op, b) => a - b);

    final parser = builder.build().end();
    try {
      final result = parser.parse(_mathInputFieldObjCon.text);
      if (result is Success) {
        setState(() => _radarLogDisplay = """
✅ 解析成功：
公式：${_mathInputFieldObjCon.text}
👑 最终结果：${result.value}
        """);
      } else {
        setState(() => _radarLogDisplay = "❌ 语法错误！${result.message}");
      }
    } catch (e) {
      setState(() => _radarLogDisplay = "❌ 报错：${e.toString()}");
    }
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('5.1 复杂语法解析演示')),
      body: SingleChildScrollView(
        padding: const EdgeInsets.all(16.0),
        child: Column(
          children: [
            const Text("PetitParser 可以在应用端构建高级编辑器和复杂语法解析引擎：",
                style: TextStyle(color: Colors.blueGrey)),
            const SizedBox(height: 20),
            TextField(
                controller: _mathInputFieldObjCon,
                decoration: const InputDecoration(labelText: '请输入复杂数学公式')),
            const SizedBox(height: 15),
            ElevatedButton.icon(
              icon: const Icon(Icons.calculate),
              label: const Text('执行解析'),
              onPressed: _triggerSeekAndAcquireValues,
            ),
            const SizedBox(height: 30),
            Container(
              width: double.infinity,
              padding: const EdgeInsets.all(12),
              decoration: BoxDecoration(
                  color: Colors.black, borderRadius: BorderRadius.circular(12)),
              child: SelectableText(_radarLogDisplay,
                  style: const TextStyle(
                      color: Colors.limeAccent,
                      fontSize: 13,
                      fontFamily: 'monospace')),
            )
          ],
        ),
      ),
    );
  }
}

六、总结

petitparser 为 OpenHarmony 开发者提供了极其灵活的语法处理能力。无论是简单的字符串提取，还是复杂的脚本引擎开发，它都能以优雅的组合模式提供高质量支持，显著提升应用的智能化支持水平。